courrier 0.5.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7b53b10ca70de7f78cc85b10132ef28629ab062421e0d8ba0c7179b69e45d98d
-  data.tar.gz: 95aecbc0697a720292f9bf3e98e32a5a50637c73367b121fdd5549c6dfbe8f9a
+  metadata.gz: 1359782140920863fe902186544d8b34bcbc513ca4412b26bc3bea975196916e
+  data.tar.gz: 493af39e04f09434689cb810a57c591b02ec9373b84660de4de0349c168eebfb
 SHA512:
-  metadata.gz: 42d52645c4ee70b04ec3005c699555f17ab3f93da25096d9c240126b6765e4f00197dafba99f0eaeec873df5577bbb828e9d177877d16c7611f6a2087cfc990f
-  data.tar.gz: 03e8724821bc2452e4f838564f7e12ea3654658a20c4eb5c4c2d1b782f7f53e66972a6b88e48490c23ab652e1a8f8df710573028ac88b7c186876462bc36916e
+  metadata.gz: d7928a0eb201e6b4b5e36612a03641c49a862477c6338be08800e10c1a4b9cc5f8e1917253a2a2b9b414c51ef361c9dcbfe87a309e1fcba22fb8af43310f068e
+  data.tar.gz: 9a4c22a760d6c9af901beaa076a30dcbe02db45b2c339932bef2a3e6df90531d3bdaf860c86bb954d0397243b73c4b2b07dd4072eef6cd5c9d641a9e2f3303fd

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    courrier (0.5.1)
+    courrier (0.7.0)
       launchy (>= 3.1, < 4)
       nokogiri (>= 1.18, < 2)
 

data/README.md

@@ -1,8 +1,8 @@
 # Courrier
 
-Modern, API-powered email delivery for Ruby apps.
+API-powered email delivery for Ruby apps.
 
-![A cute cartoon mascot wearing a blue postal uniform with red scarf and cap, carrying a leather messenger bag, representing a modern email delivery system for Ruby applications](https://raw.githubusercontent.com/Rails-Designer/courrier/HEAD/.github/cover.jpg)
+![A cute cartoon mascot wearing a blue postal uniform with red scarf and cap, carrying a leather messenger bag, representing an API-powered email delivery system for Ruby applications](https://raw.githubusercontent.com/Rails-Designer/courrier/HEAD/.github/cover.jpg)
 
 ```ruby
 # Quick example
@@ -108,7 +108,8 @@ Provider and API key settings can be overridden using environment variables (`CO
 
 Besides the standard email attributes (`from`, `to`, `reply_to`, etc.), you can pass any additional attributes that will be available in your email templates:
 ```ruby
-OrderEmail.deliver to: "recipient@railsdesigner.com", download_url: downloads_path(token: "token")
+OrderEmail.deliver to: "recipient@railsdesigner.com",\
+                   download_url: downloads_path(token: "token")
 ```
 
 These custom attributes are accessible directly in your email class:
@@ -159,25 +160,36 @@ Courrier supports these transactional email providers:
 - [Mailjet](https://mailjet.com)
 - [MailPace](https://mailpace.com)
 - [Postmark](https://postmarkapp.com)
+- [Resend](https://resend.com)
 - [SendGrid](https://sendgrid.com)
 - [SparkPost](https://sparkpost.com)
+- [Userlist](https://userlist.com)
 
 ⚠️ Some providers still need manual verification of their implementation. If you're using one of these providers, please help verify the implementation by sharing your experience in [this GitHub issue](https://github.com/Rails-Designer/courrier/issues/4). 🙏
 
 
 ## More Features
 
-Additional functionality to help with development and email handling:
+Additional functionality to help with development and testing:
+
 
+### Inbox (Rails only)
 
-### Email Preview
+You can preview your emails in the inbox:
+```ruby
+config.provider = "inbox"
+
+# And add to your routes:
+mount Courrier::Engine => "/courrier"
+```
 
-Preview emails in your browser during development:
+If you want to automatically open every email in your default browser:
 ```ruby
-config.provider = "preview" # Opens emails in your default browser
+config.provider = "inbox"
+config.inbox.auto_open = true
 ```
 
-Previews are automatically cleared with `bin/rails tmp:clear`, or manually with `bin/rails courrier:clear`.
+Emails are automatically cleared with `bin/rails tmp:clear`, or manually with `bin/rails courrier:clear`.
 
 
 ### Layout Support

data/app/controllers/courrier/previews/cleanups_controller.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Courrier
+  module Previews
+    class CleanupsController < ActionController::Base
+      def create
+        system("bin/rails courrier:clear")
+
+        redirect_to root_path
+      end
+    end
+  end
+end

data/app/controllers/courrier/previews_controller.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Courrier
+  class PreviewsController < ActionController::Base
+    def index
+      @emails = emails.map { Courrier::Email::Providers::Inbox::Email.from_file(_1) }
+    end
+
+    def show
+      file_path = File.join(Courrier.configuration.inbox.destination, params[:id])
+      content = File.read(file_path)
+
+      render html: content.html_safe, layout: false
+    end
+
+    private
+
+    def emails
+      @emails ||= Dir.glob("#{Courrier.configuration.inbox.destination}/*.html")
+        .sort_by { -File.basename(_1, ".html").to_i }
+    end
+  end
+end

data/app/views/courrier/previews/index.html.erb

@@ -0,0 +1,171 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8">
+    <title>Courrier Inbox</title>
+
+    <style>
+      *, *::before, *::after { box-sizing: border-box; }
+      * { margin: 0; padding: 0; }
+      body { margin: 0; padding: 0; font-size: 16px; line-height: 1.5; font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; background-color: rgb(241,  245, 249); }
+
+      .sidebar {
+        display: flex;
+        flex-direction: column;
+        position: sticky;
+        top: 0;
+        padding: .5rem;
+        width: min(350px, 33.3333%); height: 100dvh;
+        border-right: 1px solid rgb(226, 232, 240);
+      }
+
+      .sidebar__options {
+        position: sticky;
+        bottom: 0;
+        padding: .5rem;
+        background-color: rgb(241, 245, 249);
+      }
+
+      .sidebar__btn-clear {
+        border: none;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        column-gap: 0.25rem;
+        width: 100%;
+        padding: .5rem;
+        font-size: .875rem; line-height: 1.25rem;
+        font-weight: 500;
+        color: rgb(71, 85, 105);
+        background-color: rgb(226, 232, 240);
+        border-radius: .5rem;
+        cursor: default;
+
+        &:hover { background-color: rgb(203, 213, 225); }
+        &:active { transform: scale(.98); }
+
+        [data-slot="icon"] {
+          width: .875rem; height: .875rem;
+        }
+      }
+
+      .email-previews {
+        display: flex;
+        flex-direction: column;
+        flex: 1;
+        row-gap: .5rem;
+        overflow-y: auto;
+        width: 100%;
+      }
+
+      .email-preview {
+        display: flex;
+        flex-direction: row;
+        column-gap: .5rem;
+        width: 100%;
+        padding: .5rem .75rem;
+        text-decoration: none;
+        border-radius: .5rem;
+
+        &:hover {
+          background-color: rgba(226, 232, 240, .75);
+        }
+      }
+
+      .email-preview--empty {
+        display: none;
+        text-align: center;
+
+        &:only-child {
+          display: block;
+        }
+      }
+
+      .email-preview__avatar {
+        flex-shrink: 0;
+        padding: .25rem;
+        width: 1.5rem; height: 1.5rem;
+        background-color: rgb(203, 213, 225);
+        color: rgb(51, 65, 85);
+        border-radius: 9999px;
+      }
+
+      .email-preview__content {
+        font-size: 0.875rem; line-height: 1.25rem;
+      }
+
+      .email-preview__recipient {
+        font-size: 1rem; line-height: 1.5rem;
+        font-weight: 600;
+        letter-spacing: -.025em;
+        color: rgb(51, 65, 85);
+      }
+
+      .email-preview__subject {
+        margin-top: .125rem;
+        overflow: hidden; display: -webkit-box; -webkit-box-orient: vertical; -webkit-line-clamp: 1;
+        color: rgb(100, 116, 139);
+      }
+    </style>
+  </head>
+  <body>
+    <div style="display: flex; column-gap: 1rem;">
+      <aside class="sidebar">
+        <ul class="email-previews">
+          <li class="email-preview--empty">
+            <p class="email-preview__subject">
+              No emails yet…
+            </p>
+          </li>
+
+          <% @emails.each do |email| %>
+            <li>
+              <%= link_to courrier.preview_path(email.filename), data: {remote: true}, class: "email-preview" do %>
+                <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true" data-slot="icon" class="email-preview__avatar">
+                  <path fill-rule="evenodd" d="M7.5 6a4.5 4.5 0 1 1 9 0 4.5 4.5 0 0 1-9 0ZM3.751 20.105a8.25 8.25 0 0 1 16.498 0 .75.75 0 0 1-.437.695A18.683 18.683 0 0 1 12 22.5c-2.786 0-5.433-.608-7.812-1.7a.75.75 0 0 1-.437-.695Z" clip-rule="evenodd"/>
+                </svg>
+
+                <div class="email-preview__content">
+                  <small class="email-preview__recipient">
+                    <%= email.metadata.to %>
+                  </small>
+
+                  <p class="email-preview__subject">
+                    <%= email.metadata.subject || "No subject" %>
+                  </p>
+                </div>
+              <% end %>
+            </li>
+          <% end %>
+        </ul>
+
+        <div class="sidebar__options">
+          <%= button_to courrier.cleanup_path, class: "sidebar__btn-clear" do %>
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true" data-slot="icon">
+              <path fill-rule="evenodd" d="M16.5 4.478v.227a48.816 48.816 0 0 1 3.878.512.75.75 0 1 1-.256 1.478l-.209-.035-1.005 13.07a3 3 0 0 1-2.991 2.77H8.084a3 3 0 0 1-2.991-2.77L4.087 6.66l-.209.035a.75.75 0 0 1-.256-1.478A48.567 48.567 0 0 1 7.5 4.705v-.227c0-1.564 1.213-2.9 2.816-2.951a52.662 52.662 0 0 1 3.369 0c1.603.051 2.815 1.387 2.815 2.951Zm-6.136-1.452a51.196 51.196 0 0 1 3.273 0C14.39 3.05 15 3.684 15 4.478v.113a49.488 49.488 0 0 0-6 0v-.113c0-.794.609-1.428 1.364-1.452Zm-.355 5.945a.75.75 0 1 0-1.5.058l.347 9a.75.75 0 1 0 1.499-.058l-.346-9Zm5.48.058a.75.75 0 1 0-1.498-.058l-.347 9a.75.75 0 0 0 1.5.058l.345-9Z" clip-rule="evenodd"/>
+            </svg>
+
+            Clear inbox
+          <% end %>
+        </div>
+      </aside>
+
+      <article style="flex: 1;" id="email-preview">
+      </article>
+    </div>
+
+    <script>
+      document.querySelectorAll("a[data-remote]").forEach(link => {
+        link.addEventListener("click", (event) => {
+          event.preventDefault();
+
+          fetch(link.href)
+            .then(response => response.text())
+            .then(html => {
+              document.getElementById("email-preview").innerHTML = html;
+            });
+        });
+      });
+    </script>
+  </body>
+</html>

data/config/routes.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+Courrier::Engine.routes.draw do
+  resources :previews, only: %w[show], constraints: {id: /.*\.html/}
+  resource :cleanup, only: %w[create], module: "previews"
+
+  root "previews#index"
+end

data/courrier.gemspec

@@ -8,15 +8,15 @@ Gem::Specification.new do |spec|
   spec.authors = ["Rails Designer"]
   spec.email = ["devs@railsdesigner.com"]
 
-  spec.summary = "Modern, API-powered email delivery for Rails apps"
-  spec.description = "Modern, API-powered email delivery for Ruby apps with support for Postmark, SendGrid, Mailgun and more."
+  spec.summary = "API-powered email delivery for Ruby apps"
+  spec.description = "API-powered email delivery for Ruby apps with support for Postmark, SendGrid, Mailgun and more."
   spec.homepage = "https://railsdesigner.com/courrier/"
   spec.license = "MIT"
 
   spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = "https://github.com/Rails-Designer/courrier/"
 
-  spec.files = Dir["{bin,app,config,db,lib,public}/**/*", "Rakefile", "README.md", "courrier.gemspec", "Gemfile", "Gemfile.lock"]
+  spec.files = Dir["{bin,app,config,lib}/**/*", "Rakefile", "README.md", "courrier.gemspec", "Gemfile", "Gemfile.lock"]
 
   spec.required_ruby_version = ">= 3.2.0"
 

data/lib/courrier/configuration/{preview.rb → inbox.rb}

@@ -2,13 +2,13 @@
 
 module Courrier
   class Configuration
-    class Preview
+    class Inbox
       attr_accessor :destination, :auto_open, :template_path
 
       def initialize
         @destination = default_destination
-        @auto_open = true
-        @template_path = File.expand_path("../../../courrier/email/providers/preview/default.html.erb", __FILE__)
+        @auto_open = false
+        @template_path = File.expand_path("../../../courrier/email/providers/inbox/default.html.erb", __FILE__)
       end
 
       private

data/lib/courrier/configuration.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require "courrier/configuration/preview"
+require "courrier/configuration/inbox"
 require "courrier/configuration/providers"
 
 module Courrier
@@ -21,7 +21,7 @@ module Courrier
   class Configuration
     attr_accessor :provider, :api_key, :logger, :email_path, :layouts, :default_url_options, :auto_generate_text,
       :from, :reply_to, :cc, :bcc
-    attr_reader :providers, :preview
+    attr_reader :providers, :inbox
 
     def initialize
       @provider = "logger"
@@ -39,7 +39,7 @@ module Courrier
       @bcc = nil
 
       @providers = Courrier::Configuration::Providers.new
-      @preview = Courrier::Configuration::Preview.new
+      @inbox = Courrier::Configuration::Inbox.new
     end
 
     private

data/lib/courrier/email/provider.rb

@@ -1,24 +1,27 @@
 # frozen_string_literal: true
 
 require "courrier/email/providers/base"
+require "courrier/email/providers/inbox"
 require "courrier/email/providers/logger"
 require "courrier/email/providers/loops"
 require "courrier/email/providers/mailgun"
 require "courrier/email/providers/mailjet"
 require "courrier/email/providers/mailpace"
 require "courrier/email/providers/postmark"
-require "courrier/email/providers/preview"
+require "courrier/email/providers/resend"
 require "courrier/email/providers/sendgrid"
 require "courrier/email/providers/sparkpost"
+require "courrier/email/providers/userlist"
 
 module Courrier
   class Email
     class Provider
-      def initialize(provider: nil, api_key: nil, options: {}, provider_options: {})
+      def initialize(provider: nil, api_key: nil, options: {}, provider_options: {}, context_options: {})
         @provider = provider
         @api_key = api_key
         @options = options
         @provider_options = provider_options
+        @context_options = context_options
       end
 
       def deliver
@@ -28,22 +31,25 @@ module Courrier
         provider_class.new(
           api_key: @api_key,
           options: @options,
-          provider_options: @provider_options
+          provider_options: @provider_options,
+          context_options: @context_options
         ).deliver
       end
 
       private
 
       PROVIDERS = {
+        inbox: Courrier::Email::Providers::Inbox,
         logger: Courrier::Email::Providers::Logger,
         loops: Courrier::Email::Providers::Loops,
         mailgun: Courrier::Email::Providers::Mailgun,
         mailjet: Courrier::Email::Providers::Mailjet,
         mailpace: Courrier::Email::Providers::Mailpace,
         postmark: Courrier::Email::Providers::Postmark,
-        preview: Courrier::Email::Providers::Preview,
+        resend: Courrier::Email::Providers::Resend,
         sendgrid: Courrier::Email::Providers::Sendgrid,
-        sparkpost: Courrier::Email::Providers::Sparkpost
+        sparkpost: Courrier::Email::Providers::Sparkpost,
+        userlist: Courrier::Email::Providers::Userlist
       }.freeze
 
       def configuration_missing_in_production?

data/lib/courrier/email/providers/base.rb

@@ -6,10 +6,11 @@ module Courrier
   class Email
     module Providers
       class Base
-        def initialize(api_key: nil, options: {}, provider_options: {})
+        def initialize(api_key: nil, options: {}, provider_options: {}, context_options: {})
           @api_key = api_key
           @options = options
           @provider_options = provider_options
+          @context_options = context_options
         end
 
         def deliver

data/lib/courrier/email/providers/{preview → inbox}/default.html.erb

@@ -1,3 +1,10 @@
+<!--
+{
+  "to": "<%= email %>",
+  "subject": "<%= @options.subject %>"
+}
+-->
+
 <!DOCTYPE html>
 <html>
   <head>
@@ -6,7 +13,7 @@
     <style>
       *, *::before, *::after { box-sizing: border-box; }
       * { margin: 0; padding: 0; }
-      body { margin: 0; padding: .5rem; line-height: 1.5; font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; background-color: rgb(241,  245, 249); }
+      body { margin: 0; padding: 0; line-height: 1.5; font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; background-color: rgb(241,  245, 249); }
       pre { margin: 0; white-space: pre-wrap; }
       .email {
         width: 100%;
@@ -14,15 +21,15 @@
         margin-left: auto; margin-right: auto;
         background-color: #fff;
         box-shadow: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1);
-        border-radius: 1rem;
+        border-bottom-right-radius: 1rem; border-bottom-left-radius: 1rem;
       }
 
-      .email__header { display: flex; align-items: center; padding: 1rem .75rem; -moz-column-gap: .75rem; column-gap: .75rem; }
+      .email__header { display: flex; align-items: center; padding: .75rem; -moz-column-gap: .75rem; column-gap: .75rem; }
 
       .email__avatar {
         flex-shrink: 0;
         padding: .25rem;
-        width: 2.5rem; height: 2.5rem;
+        width: 2rem; height: 2rem;
         background-color: rgb(203, 213, 225);
         color: rgb(51, 65, 85);
         border-radius: 9999px;
@@ -39,14 +46,14 @@
       .email__datetime { font-size: .75rem; line-height: 1rem; color: rgb(148, 163, 184); }
 
       .email__subject {
-        margin-left: 4rem;
+        margin-left: 3.5rem;
         font-size: 1.25rem; line-height: 1.75rem;
         font-weight: 700;
         letter-spacing: -.025em;
         color: rgb(30, 41, 59)
       }
 
-      .email__preview { margin-top: .75rem; margin-left: 4rem; padding: .5rem .25rem; }
+      .email__preview { margin-top: .75rem; margin-left: 3.5rem; padding-bottom: 1rem; }
 
       .preview-toggle { display: none; }
       .preview-toggle-label {

data/lib/courrier/email/providers/inbox.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require "tmpdir"
+require "fileutils"
+require "launchy"
+
+module Courrier
+  class Email
+    module Providers
+      class Inbox < Base
+        def deliver
+          FileUtils.mkdir_p(config.destination)
+
+          file_path = File.join(config.destination, "#{Time.now.to_i}.html")
+
+          File.write(file_path, ERB.new(File.read(config.template_path)).result(binding))
+
+          Launchy.open(file_path) if config.auto_open
+
+          "📮 Email saved to #{file_path} and #{email_destination}"
+        end
+
+        def name = extract(@options.to)[:name]
+
+        def email = extract(@options.to)[:email]
+
+        def text = prepare(@options.text)
+
+        def html = prepare(@options.html)
+
+        private
+
+        def extract(to)
+          if to.to_s =~ /(.*?)\s*<(.+?)>/
+            {name: $1.strip, email: $2.strip}
+          else
+            {name: nil, email: to.to_s.strip}
+          end
+        end
+
+        def prepare(content)
+          content.to_s.gsub(URI::DEFAULT_PARSER.make_regexp(%w[http https])) do |url|
+            %(<a href="#{url}">#{url}</a>)
+          end
+        end
+
+        def config = @config ||= Courrier.configuration.inbox
+
+        def email_destination
+          return "opened in your default browser" if config.auto_open
+
+          path = begin
+            Rails.application.routes.url_helpers.courrier_path
+          rescue
+            "/courrier/ (Note: Add `mount Courrier::Engine => \"/courrier\"` to your routes.rb to enable proper routing)"
+          end
+
+          "available at #{path}"
+        end
+
+        class Email < Data.define(:path, :filename, :metadata)
+          Metadata = Data.define(:to, :subject)
+
+          def self.from_file(path)
+            content = File.read(path)
+            json = content[/<!--\s*(.*?)\s*-->/m, 1]
+            metadata = JSON.parse(json, symbolize_names: true)
+
+            new(
+              path: path,
+              filename: File.basename(path),
+              metadata: Metadata.new(**metadata)
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/courrier/email/providers/loops.rb

@@ -22,14 +22,7 @@ module Courrier
           }
         end
 
-        def data_variables
-          {
-            "from" => @options.from,
-            "subject" => @options.subject,
-            "text_content" => @options.text,
-            "html_content" => @options.html
-          }.compact
-        end
+        def data_variables = @context_options.compact
       end
     end
   end

data/lib/courrier/email/providers/mailgun.rb

@@ -29,7 +29,11 @@ module Courrier
 
         def content_type = "multipart/form-data"
 
-        def authentication_for(request) = request.basic_auth("api", @api_key)
+        def headers
+          {
+            "Authorization" => "Basic #{Base64.strict_encode64("api:#{@api_key}")}"
+          }
+        end
       end
     end
   end

data/lib/courrier/email/providers/resend.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Courrier
+  class Email
+    module Providers
+      class Resend < Base
+        ENDPOINT_URL = "https://api.resend.com/emails"
+
+        def body
+          {
+            "from" => @options.from,
+            "to" => @options.to,
+            "reply_to" => @options.reply_to,
+            "cc" => @options.cc,
+            "bcc" => @options.bcc,
+            "subject" => @options.subject,
+            "text" => @options.text,
+            "html" => @options.html
+          }.compact
+        end
+
+        private
+
+        def headers
+          {
+            "Authorization" => "Bearer #{@api_key}"
+          }
+        end
+      end
+    end
+  end
+end

data/lib/courrier/email/providers/userlist.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Courrier
+  class Email
+    module Providers
+      class Userlist < Base
+        ENDPOINT_URL = "https://push.userlist.com/messages"
+
+        def body
+          {
+            "from" => @options.from,
+            "to" => @options.to,
+            "subject" => @options.subject,
+            "body" => body_document
+          }.compact.merge(provider_options)
+        end
+
+        private
+
+        def headers
+          {
+            "Authorization" => "Push #{@api_key}"
+          }
+        end
+
+        def body_document
+          if @options.html && @options.text
+            multipart_document
+          elsif @options.html
+            html_document
+          elsif @options.text
+            text_document
+          end
+        end
+
+        def text_document
+          {
+            "type" => "text",
+            "content" => @options.text
+          }
+        end
+
+        def html_document
+          {
+            "type" => "html",
+            "content" => @options.html
+          }
+        end
+
+        def multipart_document
+          {
+            "type" => "multipart",
+            "content" => [
+              html_document,
+              text_document
+            ]
+          }
+        end
+
+        def provider_options
+          {"theme" => nil}.merge(@provider_options)
+        end
+      end
+    end
+  end
+end

data/lib/courrier/email.rb

@@ -79,7 +79,8 @@ module Courrier
         provider: @provider,
         api_key: @api_key,
         options: @options,
-        provider_options: Courrier.configuration&.providers&.[](@provider.to_s.downcase.to_sym)&.to_h
+        provider_options: Courrier.configuration&.providers&.[](@provider.to_s.downcase.to_sym),
+        context_options: @context_options
       ).deliver
     end
     alias_method :deliver_now, :deliver

data/lib/courrier/engine.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Courrier
+  class Engine < ::Rails::Engine
+    isolate_namespace Courrier
+  end
+end

data/lib/courrier/tasks/courrier.rake

@@ -1,13 +1,13 @@
 namespace :tmp do
   task :courrier do
-    rm_rf Dir["#{Courrier.configuration.preview.destination}/[^.]*"], verbose: false
+    rm_rf Dir["#{Courrier.configuration.inbox.destination}/[^.]*"], verbose: false
   end
 
   task clear: :courrier
 end
 
 namespace :courrier do
-  desc "Clear preview email files from `#{Courrier.configuration.preview.destination}`"
+  desc "Clear email files from `#{Courrier.configuration.inbox.destination}`"
 
   task clear: "tmp:courrier"
 end

data/lib/courrier/version.rb

@@ -1,3 +1,3 @@
 module Courrier
-  VERSION = "0.5.1"
+  VERSION = "0.7.0"
 end

data/lib/courrier.rb

@@ -4,6 +4,7 @@ require "courrier/version"
 require "courrier/errors"
 require "courrier/configuration"
 require "courrier/email"
+require "courrier/engine" if defined?(Rails)
 require "courrier/railtie" if defined?(Rails)
 
 module Courrier

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: courrier
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Rails Designer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-12 00:00:00.000000000 Z
+date: 2025-05-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: launchy
@@ -50,8 +50,8 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '2'
-description: Modern, API-powered email delivery for Ruby apps with support for Postmark,
-  SendGrid, Mailgun and more.
+description: API-powered email delivery for Ruby apps with support for Postmark, SendGrid,
+  Mailgun and more.
 email:
 - devs@railsdesigner.com
 executables: []
@@ -62,13 +62,17 @@ files:
 - Gemfile.lock
 - README.md
 - Rakefile
+- app/controllers/courrier/previews/cleanups_controller.rb
+- app/controllers/courrier/previews_controller.rb
+- app/views/courrier/previews/index.html.erb
 - bin/console
 - bin/release
 - bin/setup
+- config/routes.rb
 - courrier.gemspec
 - lib/courrier.rb
 - lib/courrier/configuration.rb
-- lib/courrier/configuration/preview.rb
+- lib/courrier/configuration/inbox.rb
 - lib/courrier/configuration/providers.rb
 - lib/courrier/email.rb
 - lib/courrier/email/address.rb
@@ -76,19 +80,22 @@ files:
 - lib/courrier/email/options.rb
 - lib/courrier/email/provider.rb
 - lib/courrier/email/providers/base.rb
+- lib/courrier/email/providers/inbox.rb
+- lib/courrier/email/providers/inbox/default.html.erb
 - lib/courrier/email/providers/logger.rb
 - lib/courrier/email/providers/loops.rb
 - lib/courrier/email/providers/mailgun.rb
 - lib/courrier/email/providers/mailjet.rb
 - lib/courrier/email/providers/mailpace.rb
 - lib/courrier/email/providers/postmark.rb
-- lib/courrier/email/providers/preview.rb
-- lib/courrier/email/providers/preview/default.html.erb
+- lib/courrier/email/providers/resend.rb
 - lib/courrier/email/providers/sendgrid.rb
 - lib/courrier/email/providers/sparkpost.rb
+- lib/courrier/email/providers/userlist.rb
 - lib/courrier/email/request.rb
 - lib/courrier/email/result.rb
 - lib/courrier/email/transformer.rb
+- lib/courrier/engine.rb
 - lib/courrier/errors.rb
 - lib/courrier/railtie.rb
 - lib/courrier/tasks/courrier.rake
@@ -121,5 +128,5 @@ requirements: []
 rubygems_version: 3.4.1
 signing_key:
 specification_version: 4
-summary: Modern, API-powered email delivery for Rails apps
+summary: API-powered email delivery for Ruby apps
 test_files: []

data/lib/courrier/email/providers/preview.rb

@@ -1,51 +0,0 @@
-# frozen_string_literal: true
-
-require "tmpdir"
-require "fileutils"
-require "launchy"
-
-module Courrier
-  class Email
-    module Providers
-      class Preview < Base
-        def deliver
-          FileUtils.mkdir_p(config.destination)
-
-          file_path = File.join(config.destination, "#{Time.now.to_i}.html")
-
-          File.write(file_path, ERB.new(File.read(config.template_path)).result(binding))
-
-          Launchy.open(file_path)
-
-          "Preview email saved to #{file_path}#{config.auto_open ? " and opened in browser" : ""}"
-        end
-
-        def name = extract(@options.to)[:name]
-
-        def email = extract(@options.to)[:email]
-
-        def text = prepare(@options.text)
-
-        def html = prepare(@options.html)
-
-        private
-
-        def extract(to)
-          if to.to_s =~ /(.*?)\s*<(.+?)>/
-            {name: $1.strip, email: $2.strip}
-          else
-            {name: nil, email: to.to_s.strip}
-          end
-        end
-
-        def prepare(content)
-          content.to_s.gsub(URI::DEFAULT_PARSER.make_regexp(%w[http https])) do |url|
-            %(<a href="#{url}">#{url}</a>)
-          end
-        end
-
-        def config = @config ||= Courrier.configuration.preview
-      end
-    end
-  end
-end