courrier 0.11.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d793cbc73ad9612cbb5e010e6aed85f9885e41fc8b672d16f82a6d155f63b726
-  data.tar.gz: 1143fc17abc330c3f94192ec95aea7618583266491f109b62aee3178826ede97
+  metadata.gz: 802112a2d410713a25a67fca11af1a9021cf8f5bd15efe55590bb6d41dcf188b
+  data.tar.gz: ac7fd7ab96871921876c79e20a623baa5d7a8fd9ab5ad13b23e3ae9e2631cc57
 SHA512:
-  metadata.gz: 64991e00fdb46c81164c29ffc7dc9de6078bcbc6cad12407355424f19f54e3a767e8732abf1438105d1f14b3ebe8ecf8367aa88bd7e53fadd7787fa8dd163609
-  data.tar.gz: eed7664f6a7211fc98e8cd53e0dc24ad1784e5373575c006feb04fb7d3a2706da3127c0db801b3c960697f774cd3df68df3622b975f365ed5fdfa211327aa3d3
+  metadata.gz: 350843ff6b853bb92e797d87dd5b485ad095d3f8a70a2129863ea141e11dcf6f0fd90c8a680bf5f731ce38690e0bc0f47dba60ca61cb3ab9089d7b8d524bfaf8
+  data.tar.gz: 222f3088acd972aa5f282e4a29d5f7a2035b2373c10804ff97db89651cb09ead6938117734144c182b2b7268ff64285833674782b38d966145635818a49d2a14

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    courrier (0.11.0)
+    courrier (1.1.0)
       logger (>= 1.5, < 3)
       nokogiri (>= 1.18, < 2)
 

data/README.md

@@ -96,6 +96,7 @@ Courrier.configure do |config|
   config.providers.cloudflare.account_id = "your-account-id"
   config.providers.loops.transactional_id = "default-template"
   config.providers.mailgun.domain = "notifications.railsdesigner.com"
+  config.providers.smtpcom.channel = "your-sender-channel"
 
   config.providers.ses.region = "us-east-1"
   config.providers.ses.access_key_id = "your-access-key-id"
@@ -121,12 +122,10 @@ OrderEmail.deliver to: "recipient@railsdesigner.com",\
 ```
 
 
-Provider and API key settings can be overridden using environment variables (`COURRIER_PROVIDER` and `COURRIER_API_KEY`) for both global configuration and email class defaults.
-
 
 ## Custom headers
 
-Email classes can define custom HTTP headers that are sent with every email:
+Email classes can define custom headers that are sent with every email:
 ```ruby
 class OrderEmail < Courrier::Email
   headers list_unsubscribe_post: "List-Unsubscribe=One-Click"
@@ -194,71 +193,34 @@ end
 Courrier supports these transactional email providers:
 
 - [AWS SES](https://aws.amazon.com/ses/) — requires `aws-sigv4` gem
+- [Brevo](https://www.brevo.com/)
 - [Cloudflare Email Service](https://developers.cloudflare.com/email-service/)
 - [Lettermint](https://lettermint.co)
 - [Loops](https://loops.so)
+- [MailerSend](https://www.mailersend.com/)
 - [Mailgun](https://mailgun.com)
+- [MailKite](https://mailkite.dev)
 - [MailPace](https://mailpace.com)
+- [Mailtrap](https://mailtrap.io)
 - [Postmark](https://postmarkapp.com)
 - [Resend](https://resend.com)
 - [SendGrid](https://sendgrid.com)
 - [SMTP2GO](https://www.smtp2go.com/)
+- [SMTP.com](https://www.smtp.com/) — requires a `channel`
 - [SparkPost](https://www.sparkpost.com/)
 - [Userlist](https://userlist.com)
 
 
 ## More Features
 
-Additional functionality to help with development and testing:
-
-
-### Layout support
-
-Wrap your email content using layouts:
-```ruby
-class OrderEmail < Courrier::Email
- layout text: "%{content}\n\nThanks for your order!",
-        html: "<div>\n%{content}\n</div>"
-end
-```
-
-Using a method:
-```ruby
-class OrderEmail < Courrier::Email
-  layout html: :html_layout
-
-  def html_layout
-    <<~HTML
-      <div style='font-family: ui-sans-serif, system-ui;'>
-        %{content}
-      </div>
-    HTML
-  end
-end
-```
-
-Using a separate class:
-```ruby
-class OrderEmail < Courrier::Email
-  layout html: OrderLayout
-end
-
-class OrderLayout
-  self.call
-    <<~HTML
-      <div style='font-family: ui-sans-serif, system-ui;'>
-        %{content}
-      </div>
-    HTML
-  end
-end
-```
+Additional functionality to go beyond the basics:
 
 
 ### Template files
 
 Instead of defining `text` and `html` methods, you can create ERB template files:
 ```ruby
+# courrier/emails/order_email.rb
 class OrderEmail < Courrier::Email
   def subject = "Your order is ready!"
 
@@ -291,7 +253,7 @@ end
 
 ## Markdown support
 
-Courrier supports rendering markdown content to HTML when a markdown gem is available. Simply bundle any supported markdown gem (`redcarpet`, `kramdown` or `commonmarker`) and it will be used.
+Courrier supports rendering markdown to HTML. Bundle any supported markdown gem (`redcarpet`, `kramdown` or `commonmarker`) and it will be used.
 
 
 ### Markdown methods
@@ -336,6 +298,49 @@ Your order **#<%= order_id %>** is ready for pickup.
 Method definitions take precedence over template files. You can mix approaches. For example, define `text` in a method and use a markdown template for HTML content.
 
 
+### Layout support
+
+Wrap your email content using layouts:
+```ruby
+class OrderEmail < Courrier::Email
+ layout text: "%{content}\n\nThanks for your order!",
+        html: "<div>\n%{content}\n</div>"
+end
+```
+
+Using a method:
+```ruby
+class OrderEmail < Courrier::Email
+  layout html: :html_layout
+
+  def html_layout
+    <<~HTML
+      <div style='font-family: ui-sans-serif, system-ui;'>
+        %{content}
+      </div>
+    HTML
+  end
+end
+```
+
+Using a separate class:
+```ruby
+class OrderEmail < Courrier::Email
+  layout html: OrderLayout
+end
+
+class OrderLayout
+  self.call
+    <<~HTML
+      <div style='font-family: ui-sans-serif, system-ui;'>
+        %{content}
+      </div>
+    HTML
+  end
+end
+```
+
+
 ### Auto-generate text from HTML
 
 Automatically generate plain text versions from your HTML emails:
@@ -344,6 +349,22 @@ config.auto_generate_text = true  # defaults to false
 ```
 
 
+### Delivery callbacks
+
+Hook into the email delivery lifecycle with `before_deliver` and `after_deliver` callbacks:
+```ruby
+class OrderEmail < Courrier::Email
+  before_deliver do |email|
+    puts "Sending to #{email.options.to}"  # access email options, abort delivery by returning false
+  end
+
+  after_deliver do |email, result|
+    puts "Delivered: #{result.success?}"  # access email and delivery result
+  end
+end
+```
+
+
 ### Email address helper
 
 Compose email addresses with display names:
@@ -365,7 +386,7 @@ end
 Use Ruby's built-in Logger for development and testing:
 
 ```ruby
-config.provider = "logger"  # outputs emails to STDOUT
+config.email = { provider: "logger" }  # outputs emails to STDOUT
 config.logger = custom_logger  # optional: defaults to ::Logger.new($stdout)
 ```
 
@@ -385,7 +406,7 @@ end
 
 Then configure it:
 ```ruby
-config.provider = "CustomProvider"
+config.email = { provider: "CustomProvider" }
 ```
 
 Check the [existing providers](https://github.com/Rails-Designer/courrier/tree/main/lib/courrier/email/providers) for implementation examples.
@@ -449,27 +470,9 @@ Available assertions:
 - `assert_email_delivered(email_class, to:, from:, subject:, provider:)`; assert an email matching criteria was delivered
 
 
-### Delivery callbacks
-
-Hook into the email delivery lifecycle with `before_deliver` and `after_deliver` callbacks:
-```ruby
-class OrderEmail < Courrier::Email
-  before_deliver do |email|
-    puts "Sending to #{email.options.to}"  # access email options, abort delivery by returning false
-  end
-
-  after_deliver do |email, result|
-    puts "Delivered: #{result.success?}"  # access email and delivery result
-  end
-end
-```
-
-Callbacks are isolated per class (subclasses don't inherit parent callbacks).
-
-
 ## Newsletter subscriptions
 
-Manage subscribers across popular email marketing platforms:
+Use Courrier to manage subscribers across popular email marketing platforms:
 ```ruby
 Courrier.configure do |config|
   config.subscriber = {
@@ -497,6 +500,7 @@ end
 ### Supported providers
 
 - [Beehiiv](https://www.beehiiv.com/) - requires `publication_id`
+- [Brevo](https://www.brevo.com/) - accepts optional `list_ids`
 - [Buttondown](https://buttondown.com)
 - [Kit](https://kit.com/) (formerly ConvertKit) - requires `form_id`
 - [Loops](https://loops.so/)
@@ -513,6 +517,14 @@ config.subscriber = {
 }
 ```
 
+For Brevo, pass one or more list IDs when new contacts should be added to specific lists:
+```ruby
+config.subscriber = {
+  provider: "brevo",
+  api_key: "your_api_key",
+  list_ids: [12, 34]
+}
+```
 
 ### Custom providers
 

data/courrier.gemspec

@@ -18,7 +18,7 @@ Gem::Specification.new do |spec|
 
   spec.files = Dir["{bin,lib}/**/*", "Rakefile", "README.md", "courrier.gemspec", "Gemfile", "Gemfile.lock"]
 
-  spec.required_ruby_version = ">= 4.0.0"
+  spec.required_ruby_version = ">= 3.4.0"
 
   spec.add_dependency "logger", ">= 1.5", "< 3"
   spec.add_dependency "nokogiri", ">= 1.18", "< 2"

data/lib/courrier/configuration.rb

@@ -42,30 +42,6 @@ module Courrier
       @providers = Courrier::Configuration::Providers.new
     end
 
-    def provider
-      warn "[DEPRECATION] `provider` is deprecated. Use `email = { provider: '…' }` instead. Will be removed in 1.0.0"
-
-      @email[:provider]
-    end
-
-    def provider=(value)
-      warn "[DEPRECATION] `provider=` is deprecated. Use `email = { provider: '…' }` instead. Will be removed in 1.0.0"
-
-      @email[:provider] = value
-    end
-
-    def api_key
-      warn "[DEPRECATION] `api_key` is deprecated. Use `email = { api_key: '…' }` instead. Will be removed in 1.0.0"
-
-      @email[:api_key]
-    end
-
-    def api_key=(value)
-      warn "[DEPRECATION] `api_key=` is deprecated. Use `email = { api_key: '…' }` instead. Will be removed in 1.0.0"
-
-      @email[:api_key] = value
-    end
-
     private
 
     def default_email_path

data/lib/courrier/context_value.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require "cgi"
+
+require "courrier/safe_string"
+
+module Courrier
+  class ContextValue
+    def initialize(value, escape:)
+      @value = value
+      @escape = escape
+    end
+
+    def to_s
+      @escape ? CGI.escapeHTML(@value.to_s) : @value.to_s
+    end
+
+    def html_safe
+      SafeString.new(@value.to_s)
+    end
+    alias_method :h, :html_safe
+
+    def method_missing(name, *arguments, &block)
+      result = @value.send(name, *arguments, &block)
+
+      result.is_a?(String) ? ContextValue.new(result, escape: @escape) : result
+    end
+
+    def respond_to_missing?(name, include_private = false)
+      @value.respond_to?(name, include_private) || super
+    end
+  end
+end

data/lib/courrier/email/options.rb

@@ -15,9 +15,9 @@ module Courrier
         @cc = options.fetch(:cc, nil)
         @bcc = options.fetch(:bcc, nil)
 
-        @subject = options.fetch(:subject, "")
-        @text = options.fetch(:text, "")
-        @html = options.fetch(:html, "")
+        @subject = options.fetch(:subject, "").to_s
+        @text = options.fetch(:text, "").to_s
+        @html = options.fetch(:html, "").to_s
 
         @auto_generate_text = options.fetch(:auto_generate_text, false)
 

data/lib/courrier/email/provider.rb

@@ -1,18 +1,23 @@
 # frozen_string_literal: true
 
 require "courrier/email/providers/base"
+require "courrier/email/providers/brevo"
 require "courrier/email/providers/cloudflare"
 require "courrier/email/providers/lettermint"
 require "courrier/email/providers/logger"
 require "courrier/email/providers/loops"
+require "courrier/email/providers/mailersend"
 require "courrier/email/providers/mailgun"
+require "courrier/email/providers/mailkite"
 require "courrier/email/providers/mailjet"
 require "courrier/email/providers/mailpace"
+require "courrier/email/providers/mailtrap"
 require "courrier/email/providers/postmark"
 require "courrier/email/providers/resend"
 require "courrier/email/providers/ses"
 require "courrier/email/providers/sendgrid"
 require "courrier/email/providers/smtp2go"
+require "courrier/email/providers/smtpcom"
 require "courrier/email/providers/sparkpost"
 require "courrier/email/providers/userlist"
 
@@ -20,18 +25,23 @@ module Courrier
   class Email
     class Provider
       PROVIDERS = {
+        brevo: Courrier::Email::Providers::Brevo,
         cloudflare: Courrier::Email::Providers::Cloudflare,
         logger: Courrier::Email::Providers::Logger,
         lettermint: Courrier::Email::Providers::Lettermint,
         loops: Courrier::Email::Providers::Loops,
+        mailersend: Courrier::Email::Providers::Mailersend,
         mailgun: Courrier::Email::Providers::Mailgun,
+        mailkite: Courrier::Email::Providers::Mailkite,
         mailjet: Courrier::Email::Providers::Mailjet,
         mailpace: Courrier::Email::Providers::Mailpace,
+        mailtrap: Courrier::Email::Providers::Mailtrap,
         postmark: Courrier::Email::Providers::Postmark,
         resend: Courrier::Email::Providers::Resend,
         ses: Courrier::Email::Providers::Ses,
         sendgrid: Courrier::Email::Providers::Sendgrid,
         smtp2go: Courrier::Email::Providers::Smtp2go,
+        smtpcom: Courrier::Email::Providers::Smtpcom,
         sparkpost: Courrier::Email::Providers::Sparkpost,
         userlist: Courrier::Email::Providers::Userlist
       }

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

@@ -6,6 +6,8 @@ module Courrier
   class Email
     module Providers
       class Base
+        def self.config_options = []
+
         def initialize(api_key: nil, options: {}, provider_options: {}, context_options: {}, custom_headers: {})
           @api_key = api_key
           @options = options
@@ -38,6 +40,23 @@ module Courrier
 
         def default_headers = {}
 
+        def address_list(value, as: :email)
+          list = value&.to_s&.split(",")&.map(&:strip)&.reject(&:empty?)
+          return unless list && !list.empty?
+
+          list.map { |address| address_element(address, as) }
+        end
+
+        def address_line(value) = address_list(value, as: :plain)&.join(", ")
+
+        def address_element(address, as)
+          case as
+          when :email then {"email" => address}
+          when :address then {"address" => address}
+          else address
+          end
+        end
+
         def provider = self.class.name.split("::").last
       end
     end

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Courrier
+  class Email
+    module Providers
+      class Brevo < Base
+        ENDPOINT_URL = "https://api.brevo.com/v3/smtp/email"
+
+        def body
+          {
+            "sender" => address_list(@options.from)&.first,
+            "to" => address_list(@options.to),
+            "cc" => address_list(@options.cc),
+            "bcc" => address_list(@options.bcc),
+            "replyTo" => address_list(@options.reply_to)&.first,
+            "subject" => @options.subject,
+            "htmlContent" => @options.html,
+            "textContent" => @options.text
+          }.compact
+        end
+
+        private
+
+        def default_headers = {"api-key" => @api_key}
+      end
+    end
+  end
+end

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

@@ -4,6 +4,8 @@ module Courrier
   class Email
     module Providers
       class Cloudflare < Base
+        def self.config_options = %w[account_id]
+
         def body
           {
             "from" => @options.from,

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

@@ -4,6 +4,8 @@ module Courrier
   class Email
     module Providers
       class Lettermint < Base
+        def self.config_options = %w[route]
+
         ENDPOINT_URL = "https://api.lettermint.co/v1/send"
 
         def body

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

@@ -4,6 +4,8 @@ module Courrier
   class Email
     module Providers
       class Loops < Base
+        def self.config_options = %w[transactional_id]
+
         ENDPOINT_URL = "https://app.loops.so/api/v1/transactional"
 
         def body

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Courrier
+  class Email
+    module Providers
+      class Mailersend < Base
+        ENDPOINT_URL = "https://api.mailersend.com/v1/email"
+
+        def body
+          {
+            "from" => address_list(@options.from)&.first,
+            "to" => address_list(@options.to),
+            "cc" => address_list(@options.cc),
+            "bcc" => address_list(@options.bcc),
+            "reply_to" => address_list(@options.reply_to)&.first,
+            "subject" => @options.subject,
+            "text" => @options.text,
+            "html" => @options.html
+          }.compact
+        end
+
+        private
+
+        def default_headers = {"Authorization" => "Bearer #{@api_key}"}
+      end
+    end
+  end
+end

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

@@ -4,6 +4,8 @@ module Courrier
   class Email
     module Providers
       class Mailgun < Base
+        def self.config_options = %w[domain]
+
         ENDPOINT_URL = "https://api.mailgun.net/v3/%{domain}/messages"
 
         def body
@@ -11,6 +13,8 @@ module Courrier
             "from" => @options.from,
 
             "to" => @options.to,
+            "cc" => address_line(@options.cc),
+            "bcc" => address_line(@options.bcc),
             "h:Reply-To" => @options.reply_to,
 
             "subject" => @options.subject,
@@ -31,7 +35,7 @@ module Courrier
 
         def default_headers
           {
-            "Authorization" => "Basic #{Base64.strict_encode64("api:#{@api_key}")}"
+            "Authorization" => "Basic #{["api:#{@api_key}"].pack("m0")}"
           }
         end
       end

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

@@ -4,6 +4,8 @@ module Courrier
   class Email
     module Providers
       class Mailjet < Base
+        def self.config_options = %w[api_secret]
+
         ENDPOINT_URL = "https://api.mailjet.com/v3.1/send"
 
         def body
@@ -14,11 +16,9 @@ module Courrier
                   "Email" => @options.from
                 },
 
-                "To" => [
-                  {
-                    "Email" => @options.to
-                  }
-                ],
+                "To" => addresses(@options.to),
+                "Cc" => addresses(@options.cc),
+                "Bcc" => addresses(@options.bcc),
                 "ReplyTo" => reply_to_object,
 
                 "Subject" => @options.subject,
@@ -33,10 +33,14 @@ module Courrier
 
         def default_headers
           {
-            "Authorization" => "Basic " + Base64.strict_encode64("#{@api_key}:#{@provider_options.api_secret}")
+            "Authorization" => "Basic #{["#{@api_key}:#{@provider_options.api_secret}"].pack("m0")}"
           }
         end
 
+        def addresses(value)
+          address_list(value, as: :plain)&.map { |address| {"Email" => address} }
+        end
+
         def reply_to_object
           return if @options.reply_to.nil?
 

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

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Courrier
+  class Email
+    module Providers
+      class Mailkite < Base
+        ENDPOINT_URL = "https://api.mailkite.dev/v1/send"
+
+        def body
+          {
+            "from" => @options.from,
+            "to" => address_list(@options.to, as: :plain),
+            "cc" => address_list(@options.cc, as: :plain),
+            "bcc" => address_list(@options.bcc, as: :plain),
+            "replyTo" => @options.reply_to,
+            "subject" => @options.subject,
+            "text" => @options.text,
+            "html" => @options.html
+          }.compact
+        end
+
+        private
+
+        def default_headers
+          {
+            "Authorization" => "Bearer #{@api_key}"
+          }
+        end
+      end
+    end
+  end
+end

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

@@ -11,6 +11,8 @@ module Courrier
             "from" => @options.from,
 
             "to" => @options.to,
+            "cc" => address_line(@options.cc),
+            "bcc" => address_line(@options.bcc),
             "replyto" => @options.reply_to,
 
             "subject" => @options.subject,

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Courrier
+  class Email
+    module Providers
+      class Mailtrap < Base
+        ENDPOINT_URL = "https://send.api.mailtrap.io/api/send"
+
+        def body
+          {
+            "from" => address_list(@options.from)&.first,
+            "to" => address_list(@options.to),
+            "cc" => address_list(@options.cc),
+            "bcc" => address_list(@options.bcc),
+            "reply_to" => address_list(@options.reply_to)&.first,
+            "subject" => @options.subject,
+            "text" => @options.text,
+            "html" => @options.html
+          }.compact
+        end
+
+        private
+
+        def default_headers = {"Api-Token" => @api_key}
+      end
+    end
+  end
+end

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

@@ -4,6 +4,8 @@ module Courrier
   class Email
     module Providers
       class Postmark < Base
+        def self.config_options = %w[message_stream]
+
         ENDPOINT_URL = "https://api.postmarkapp.com/email"
 
         def body
@@ -11,6 +13,8 @@ module Courrier
             "From" => @options.from,
 
             "To" => @options.to,
+            "Cc" => address_line(@options.cc),
+            "Bcc" => address_line(@options.bcc),
             "ReplyTo" => @options.reply_to,
 
             "Subject" => @options.subject,

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

@@ -13,12 +13,10 @@ module Courrier
             },
             "personalizations" => [
               {
-                "to" => [
-                  {
-                    "email" => @options.to
-                  }
-                ]
-              }
+                "to" => address_list(@options.to),
+                "cc" => address_list(@options.cc),
+                "bcc" => address_list(@options.bcc)
+              }.compact
             ],
             "reply_to" => reply_to_object,
 

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

@@ -4,6 +4,8 @@ module Courrier
   class Email
     module Providers
       class Ses < Base
+        def self.config_options = %w[region access_key_id secret_access_key session_token]
+
         def deliver
           uri = URI.parse("https://email.#{@provider_options[:region]}.amazonaws.com/v2/email/outbound-emails")
 

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

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Courrier
+  class Email
+    module Providers
+      class Smtpcom < Base
+        def self.config_options = %w[channel]
+
+        ENDPOINT_URL = "https://api.smtp.com/v4/messages"
+
+        def body
+          {
+            "channel" => channel,
+            "recipients" => {
+              "to" => address_list(@options.to, as: :address),
+              "cc" => address_list(@options.cc, as: :address),
+              "bcc" => address_list(@options.bcc, as: :address)
+            }.compact,
+            "originator" => {
+              "from" => address_list(@options.from, as: :address)&.first,
+              "reply_to" => address_list(@options.reply_to, as: :address)&.first
+            }.compact,
+            "subject" => @options.subject,
+            "body" => {"parts" => parts}
+          }
+        end
+
+        private
+
+        def default_headers
+          {"Authorization" => "Basic #{base64("api:#{@api_key}")}"}
+        end
+
+        def channel
+          @provider_options.channel || raise(Courrier::ArgumentError, "SMTP.com requires a `channel`")
+        end
+
+        def parts
+          [part("text/plain", @options.text), part("text/html", @options.html)].compact
+        end
+
+        def part(type, content)
+          return unless content
+
+          {
+            "type" => type,
+            "charset" => "UTF-8",
+            "encoding" => "base64",
+            "content" => base64(content)
+          }
+        end
+
+        def base64(value) = [value].pack("m0")
+      end
+    end
+  end
+end

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

@@ -13,15 +13,10 @@ module Courrier
               "from" => @options.from,
               "subject" => @options.subject,
               "text" => @options.text,
-              "html" => @options.html
+              "html" => @options.html,
+              "headers" => cc_header
             }.compact,
-            "recipients" => [
-              {
-                "address" => {
-                  "email" => @options.to
-                }
-              }
-            ]
+            "recipients" => recipients
           }
         end
 
@@ -32,6 +27,26 @@ module Courrier
             "Authorization" => @api_key
           }
         end
+
+        # SparkPost has no cc/bcc field: every copy is an entry in `recipients`, and only
+        # the addresses repeated in the CC header are shown as copied. `header_to` keeps the
+        # visible To line the same for all of them, so a bcc stays hidden and a cc is not
+        # mistaken for a to.
+        def recipients
+          [@options.to, @options.cc, @options.bcc].flat_map { |value| recipients_for(value) }
+        end
+
+        def recipients_for(value)
+          Array(address_list(value, as: :plain)).map do |address|
+            {"address" => {"email" => address, "header_to" => address_line(@options.to)}}
+          end
+        end
+
+        def cc_header
+          cc = address_line(@options.cc)
+
+          {"CC" => cc} if cc
+        end
       end
     end
   end

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

@@ -4,6 +4,8 @@ module Courrier
   class Email
     module Providers
       class Userlist < Base
+        def self.config_options = %w[theme]
+
         ENDPOINT_URL = "https://push.userlist.com/messages"
 
         def body

data/lib/courrier/email/rendering.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+require "erb"
+
+require "courrier/context_value"
+require "courrier/safe_string"
+require "courrier/markdown"
+
+module Courrier
+  class Email
+    module Rendering
+      private
+
+      def method_missing(name, *)
+        return in_html_context { render_template("html") || markdown_rendered } if name == :html
+        return render_template("text") if name == :text
+
+        value = @context_options[name]
+        return value if value.is_a?(SafeString)
+
+        value.is_a?(String) ? ContextValue.new(value, escape: @html_context) : value
+      end
+
+      def in_html_context
+        previous = @html_context
+        @html_context = true
+
+        yield
+      ensure
+        @html_context = previous
+      end
+
+      def in_safe_context
+        previous = @html_context
+        @html_context = false
+
+        yield
+      ensure
+        @html_context = previous
+      end
+
+      def render_template(format)
+        template_path = template_file_path(format)
+
+        File.exist?(template_path) ? ERB.new(File.read(template_path)).result(binding) : nil
+      end
+
+      def render_markdown_template
+        %w[md markdown].each do |ext|
+          template_path = template_file_path(ext)
+
+          return ERB.new(File.read(template_path)).result(binding) if File.exist?(template_path)
+        end
+
+        nil
+      end
+
+      def markdown_rendered
+        return unless Courrier::Markdown.available?
+
+        markdown_content = render_markdown_template || (respond_to?(:markdown, true) ? markdown : nil)
+
+        Courrier::Markdown.render(markdown_content) if markdown_content
+      end
+
+      def template_file_path(format)
+        class_path = self.class.name.gsub(/([a-z\d])([A-Z])/, '\1_\2').downcase
+
+        File.join(Courrier.configuration&.email_path, "#{class_path}.#{format}.erb")
+      end
+
+      def html_safe(value = nil, &block)
+        return in_safe_context { SafeString.new(block.call.to_s) } if block
+        return value.html_safe if value.is_a?(ContextValue)
+
+        SafeString.new(value.to_s)
+      end
+      alias_method :h, :html_safe
+
+      def respond_to_missing?(name, include_private = false) = true
+    end
+  end
+end

data/lib/courrier/email.rb

@@ -1,15 +1,15 @@
 # frozen_string_literal: true
 
-require "erb"
-
+require "courrier/email/rendering"
 require "courrier/email/address"
 require "courrier/email/layouts"
-require "courrier/markdown"
 require "courrier/email/options"
 require "courrier/email/provider"
 
 module Courrier
   class Email
+    include Rendering
+
     attr_accessor :provider, :api_key, :default_url_options, :options, :queue_options
 
     @queue_options = {}
@@ -60,11 +60,17 @@ module Courrier
       end
 
       def before_deliver_callbacks
-        @before_deliver || []
+        return @before_deliver if @before_deliver
+        return superclass.before_deliver_callbacks if superclass.respond_to?(:before_deliver_callbacks)
+
+        []
       end
 
       def after_deliver_callbacks
-        @after_deliver || []
+        return @after_deliver if @after_deliver
+        return superclass.after_deliver_callbacks if superclass.respond_to?(:after_deliver_callbacks)
+
+        []
       end
 
       def deliver(**options)
@@ -78,8 +84,8 @@ module Courrier
     end
 
     def initialize(options = {})
-      @provider = options[:provider] || ENV["COURRIER_PROVIDER"] || self.class.provider || Courrier.configuration&.email&.[](:provider)
-      @api_key = options[:api_key] || ENV["COURRIER_API_KEY"] || self.class.api_key || Courrier.configuration&.email&.[](:api_key)
+      @provider = options[:provider] || self.class.provider || Courrier.configuration&.email&.[](:provider)
+      @api_key = options[:api_key] || self.class.api_key || Courrier.configuration&.email&.[](:api_key)
 
       @default_url_options = self.class.default_url_options.merge(options[:default_url_options] || {})
       @context_options = options.except(:provider, :api_key, :from, :to, :reply_to, :cc, :bcc, :subject, :text, :html)
@@ -91,7 +97,7 @@ module Courrier
           bcc: options[:bcc] || self.class.bcc || Courrier.configuration&.bcc,
           subject: subject,
           text: text,
-          html: html,
+          html: in_html_context { html },
           auto_generate_text: Courrier.configuration&.auto_generate_text,
           layouts: Courrier::Email::Layouts.new(self).build
         )
@@ -127,46 +133,5 @@ module Courrier
     def delivery_disabled?
       ENV["COURRIER_EMAIL_DISABLED"] == "true" || ENV["COURRIER_EMAIL_ENABLED"] == "false"
     end
-
-    def method_missing(name, *)
-      if name == :text || name == :html
-        render_template(name.to_s).tap do |result|
-          return result || markdown_rendered if name == :html
-        end
-      else
-        @context_options[name]
-      end
-    end
-
-    def render_template(format)
-      template_path = template_file_path(format)
-
-      File.exist?(template_path) ? ERB.new(File.read(template_path)).result(binding) : nil
-    end
-
-    def render_markdown_template
-      %w[md markdown].each do |ext|
-        template_path = template_file_path(ext)
-
-        return ERB.new(File.read(template_path)).result(binding) if File.exist?(template_path)
-      end
-
-      nil
-    end
-
-    def markdown_rendered
-      return unless Courrier::Markdown.available?
-
-      markdown_content = render_markdown_template || (respond_to?(:markdown, true) ? markdown : nil)
-      Courrier::Markdown.render(markdown_content) if markdown_content
-    end
-
-    def template_file_path(format)
-      class_path = self.class.name.gsub(/([a-z\d])([A-Z])/, '\1_\2').downcase
-
-      File.join(Courrier.configuration&.email_path, "#{class_path}.#{format}.erb")
-    end
-
-    def respond_to_missing?(name, include_private = false) = true
   end
 end

data/lib/courrier/safe_string.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Courrier
+  class SafeString
+    def initialize(string) = @string = string.to_s
+    def to_s = @string
+    def html_safe? = true
+  end
+end

data/lib/courrier/subscriber/brevo.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require "uri"
+require "courrier/subscriber/base"
+
+module Courrier
+  class Subscriber
+    class Brevo < Base
+      ENDPOINT_URL = "https://api.brevo.com/v3/contacts"
+
+      def create(email)
+        body = {
+          "email" => email,
+          "updateEnabled" => true
+        }
+
+        list_ids = Array(Courrier.configuration.subscriber[:list_ids]).compact
+        body["listIds"] = list_ids unless list_ids.empty?
+
+        request(:post, ENDPOINT_URL, body)
+      end
+
+      def destroy(email)
+        identifier = URI.encode_www_form_component(email)
+
+        request(:delete, "#{ENDPOINT_URL}/#{identifier}")
+      end
+
+      private
+
+      def headers
+        {
+          "api-key" => @api_key,
+          "Content-Type" => "application/json"
+        }
+      end
+    end
+  end
+end

data/lib/courrier/version.rb

@@ -1,3 +1,3 @@
 module Courrier
-  VERSION = "0.11.0"
+  VERSION = "1.1.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: courrier
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Rails Designer
@@ -68,34 +68,43 @@ files:
 - lib/courrier.rb
 - lib/courrier/configuration.rb
 - lib/courrier/configuration/providers.rb
+- lib/courrier/context_value.rb
 - lib/courrier/email.rb
 - lib/courrier/email/address.rb
 - lib/courrier/email/layouts.rb
 - lib/courrier/email/options.rb
 - lib/courrier/email/provider.rb
 - lib/courrier/email/providers/base.rb
+- lib/courrier/email/providers/brevo.rb
 - 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/mailersend.rb
 - lib/courrier/email/providers/mailgun.rb
 - lib/courrier/email/providers/mailjet.rb
+- lib/courrier/email/providers/mailkite.rb
 - lib/courrier/email/providers/mailpace.rb
+- lib/courrier/email/providers/mailtrap.rb
 - 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/smtpcom.rb
 - lib/courrier/email/providers/sparkpost.rb
 - lib/courrier/email/providers/userlist.rb
+- lib/courrier/email/rendering.rb
 - lib/courrier/email/request.rb
 - lib/courrier/email/result.rb
 - lib/courrier/email/transformer.rb
 - lib/courrier/errors.rb
 - lib/courrier/markdown.rb
+- lib/courrier/safe_string.rb
 - lib/courrier/subscriber.rb
 - lib/courrier/subscriber/base.rb
 - lib/courrier/subscriber/beehiiv.rb
+- lib/courrier/subscriber/brevo.rb
 - lib/courrier/subscriber/buttondown.rb
 - lib/courrier/subscriber/kit.rb
 - lib/courrier/subscriber/loops.rb
@@ -118,14 +127,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 4.0.0
+      version: 3.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 3.6.7
 specification_version: 4
 summary: API-powered email delivery for Ruby apps
 test_files: []