courrier 0.9.0 → 0.11.0

metadata

@@ -1,35 +1,34 @@
 --- !ruby/object:Gem::Specification
 name: courrier
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.11.0
 platform: ruby
 authors:
 - Rails Designer
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-04 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: launchy
+  name: logger
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '1.5'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '4'
+        version: '3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '1.5'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '4'
+        version: '3'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
@@ -62,17 +61,12 @@ 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/inbox.rb
 - lib/courrier/configuration/providers.rb
 - lib/courrier/email.rb
 - lib/courrier/email/address.rb
@@ -80,8 +74,8 @@ 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/cloudflare.rb
+- lib/courrier/email/providers/lettermint.rb
 - lib/courrier/email/providers/logger.rb
 - lib/courrier/email/providers/loops.rb
 - lib/courrier/email/providers/mailgun.rb
@@ -90,15 +84,15 @@ files:
 - lib/courrier/email/providers/postmark.rb
 - lib/courrier/email/providers/resend.rb
 - lib/courrier/email/providers/sendgrid.rb
+- lib/courrier/email/providers/ses.rb
+- lib/courrier/email/providers/smtp2go.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/jobs/email_delivery_job.rb
-- lib/courrier/railtie.rb
+- lib/courrier/markdown.rb
 - lib/courrier/subscriber.rb
 - lib/courrier/subscriber/base.rb
 - lib/courrier/subscriber/beehiiv.rb
@@ -108,21 +102,15 @@ files:
 - lib/courrier/subscriber/mailchimp.rb
 - lib/courrier/subscriber/mailerlite.rb
 - lib/courrier/subscriber/result.rb
-- lib/courrier/tasks/courrier.rake
+- lib/courrier/test.rb
+- lib/courrier/test_helper.rb
 - lib/courrier/version.rb
-- lib/generators/courrier/email_generator.rb
-- lib/generators/courrier/install_generator.rb
-- lib/generators/courrier/templates/email.rb.tt
-- lib/generators/courrier/templates/email/password_reset.rb.tt
-- lib/generators/courrier/templates/email/welcome.rb.tt
-- lib/generators/courrier/templates/initializer.rb.tt
-homepage: https://railsdesigner.com/courrier/
+homepage: https://railsdesigner.com/open-source/courrier/
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://railsdesigner.com/courrier/
+  homepage_uri: https://railsdesigner.com/open-source/courrier/
   source_code_uri: https://github.com/Rails-Designer/courrier/
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -130,15 +118,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: 4.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.1
-signing_key:
+rubygems_version: 4.0.3
 specification_version: 4
 summary: API-powered email delivery for Ruby apps
 test_files: []

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

@@ -1,13 +0,0 @@
-# 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

@@ -1,23 +0,0 @@
-# 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

@@ -1,171 +0,0 @@
-<!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

@@ -1,8 +0,0 @@
-# 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/lib/courrier/configuration/inbox.rb

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-module Courrier
-  class Configuration
-    class Inbox
-      attr_accessor :destination, :auto_open, :template_path
-
-      def initialize
-        @destination = default_destination
-        @auto_open = false
-        @template_path = File.expand_path("../../../courrier/email/providers/inbox/default.html.erb", __FILE__)
-      end
-
-      private
-
-      def default_destination
-        defined?(Rails) ? Rails.root.join("tmp", "courrier", "emails").to_s : File.join(Dir.tmpdir, "courrier", "emails")
-      end
-    end
-  end
-end

data/lib/courrier/email/providers/inbox/default.html.erb

@@ -1,126 +0,0 @@
-<!--
-{
-  "to": "<%= email %>",
-  "subject": "<%= @options.subject %>"
-}
--->
-
-<!DOCTYPE html>
-<html>
-  <head>
-    <meta charset="UTF-8">
-    <title><%= @options.subject %></title>
-    <style>
-      *, *::before, *::after { box-sizing: border-box; }
-      * { margin: 0; padding: 0; }
-      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%;
-        max-width: 65rem;
-        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-bottom-right-radius: 1rem; border-bottom-left-radius: 1rem;
-      }
-
-      .email__header { display: flex; align-items: center; padding: .75rem; -moz-column-gap: .75rem; column-gap: .75rem; }
-
-      .email__avatar {
-        flex-shrink: 0;
-        padding: .25rem;
-        width: 2rem; height: 2rem;
-        background-color: rgb(203, 213, 225);
-        color: rgb(51, 65, 85);
-        border-radius: 9999px;
-      }
-
-      .email__recipient { flex-grow: 1; font-size: .875rem; line-height: 1.25rem; }
-
-      .email__recipient-name { font-weight: 600; color: rgb(51, 65, 85); }
-
-      .email__metadata { display: flex; align-items: center; justify-content: space-between; }
-
-      .email__recipient-email { color: rgb(100, 116, 139); }
-
-      .email__datetime { font-size: .75rem; line-height: 1rem; color: rgb(148, 163, 184); }
-
-      .email__subject {
-        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: 3.5rem; padding-bottom: 1rem; }
-
-      .preview-toggle { display: none; }
-      .preview-toggle-label {
-        display: inline-block;
-        padding: .25rem .875rem;
-        font-size: .75rem; line-height: 1rem;
-        font-weight: 600;
-        color: rgb(30, 41, 59);
-        background-color: rgb(255, 255, 255);
-        border: 1px solid rgb(226, 232, 240);
-        border-radius: .375rem;
-        box-shadow: 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1);
-        cursor: pointer;
-
-        &:hover { border-color: rgb(203, 213, 225); }
-        &:active { transform: scale(.98); }
-      }
-      .preview-toggle[disabled] + .preview-toggle-label { opacity: 0.5; cursor: not-allowed; }
-
-      .email__preview-html, .email__preview-text { margin-top: 1.5rem;}
-      .email__preview-html { display: none; }
-      .preview-toggle:checked ~ .email__preview-text { display: none; }
-      .preview-toggle:checked ~ .email__preview-html { display: block; }
-    </style>
-  </head>
-  <body>
-    <article class="email">
-      <header class="email__header">
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true" data-slot="icon" class="email__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__recipient">
-          <% if name %>
-            <p class="email__recipient-name">
-              <%= name %>
-            </p>
-          <% end %>
-
-          <div class="email__metadata">
-            <p class="email__recipient-email">
-              <%= email %>
-            </p>
-
-            <time class="email__datetime" datetime="#{Time.now.strftime("%Y-%m-%d %H:%M:%S %z")}">
-              <%= Time.now.strftime("%Y-%m-%d %H:%M:%S %z") %>
-            </time>
-          </div>
-        </div>
-      </header>
-
-      <p class="email__subject">
-        <%= @options.subject %>
-      </p>
-
-      <div class="email__preview">
-        <input type="checkbox" id="preview-toggle" class="preview-toggle" <%= html ? "" : "disabled" %>>
-        <label for="preview-toggle" class="preview-toggle-label">Toggle HTML/Text</label>
-
-        <div class="email__preview-text">
-          <pre><%= text || "(no text content)" %></pre>
-        </div>
-
-        <div class="email__preview-html">
-          <%= html || "<p>(no HTML content)</p>" %>
-        </div>
-      </div>
-    </article>
-  </body>
-</html>

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

@@ -1,83 +0,0 @@
-# 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(URL_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
-
-        URL_PARSER = (
-          defined?(URI::RFC2396_PARSER) ? URI::RFC2396_PARSER : URI::DEFAULT_PARSER
-        )
-
-        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/engine.rb

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

data/lib/courrier/jobs/email_delivery_job.rb

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-module Courrier
-  module Jobs
-    class EmailDeliveryJob < ActiveJob::Base
-      def perform(data)
-        email_class = data[:email_class].constantize
-
-        email_class.new(
-          provider: data[:provider],
-          api_key: data[:api_key],
-          from: data[:options][:from],
-          to: data[:options][:to],
-          reply_to: data[:options][:reply_to],
-          cc: data[:options][:cc],
-          bcc: data[:options][:bcc],
-          provider_options: data[:provider_options],
-          context_options: data[:context_options]
-        ).deliver_now
-      end
-    end
-  end
-end

data/lib/courrier/railtie.rb

@@ -1,23 +0,0 @@
-module Courrier
-  class Railtie < Rails::Railtie
-    config.after_initialize do
-      Courrier::Email.default_url_options = Courrier.configuration.default_url_options
-    end
-
-    ActiveSupport.on_load(:action_view) do
-      include Courrier::Email::Address
-    end
-
-    ActiveSupport.on_load(:action_controller) do
-      include Courrier::Email::Address
-    end
-
-    ActiveSupport.on_load(:active_job) do
-      include Courrier::Email::Address
-    end
-
-    rake_tasks do
-      load File.expand_path("../tasks/courrier.rake", __FILE__)
-    end
-  end
-end

data/lib/courrier/tasks/courrier.rake

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