heya 0.6.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc54010af38a9f2e0e58358f998ad7b81480955416bac5ae1a18c9b5dfdfecd3
-  data.tar.gz: ef7dbf811f3fec3c2e10e1d569f82aed0ae3309291f21a196c3dd43d28e7bf8e
+  metadata.gz: 897c67c77ab4b26f47d21ddde192e5957239cdb319c662fd72dd806de3c552d2
+  data.tar.gz: e34438a886e4c1598b0bca34bab406b84b83561310857f2c8730c669961e5a9a
 SHA512:
-  metadata.gz: 76e3d5d214c06a53cd03c388682e5c22984c874f56e73c1ebf321b08f011fd513f2402fa4e05d6abea9fe7e705f0d1330645e38de86a541210431370ec2ec71a
-  data.tar.gz: ac526b113dc81c207e7a26783b7ae63db6ccba85a2588906277eb7eaeda627930037fd195dd23c110b753fe961723b885f19d03f4f0f5a203031d18638ec53a3
+  metadata.gz: 6efc0529915073f5e3e2abb9a878e1f2e290cf66b66913989555325ac29f508988378e48637efaa36a345f3bc6ebd6978c110879c52d1999cea7bb3ec35e67a4
+  data.tar.gz: 02e88ebd7dea87ba644b380be61ffc41788c24045f8e103df302e44b1a8f82a37850ed56beb12b763b183061abf2526a5cd2affb6a175e155f7096d22a8dde7d

data/CHANGELOG.md

@@ -6,6 +6,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.0] - 2022-02-03
+### Fixed
+- Automatically include Rails url helpers from application in campaign mailer templates (#158, @feliperaul)
+
+### Added
+- Allow the customization of the to field (#155, @feliperaul)
+
 ## [0.6.1] - 2022-01-05
 ### Fixed
 - Support Rails 7 (#151, @800a7b32)

data/README.md

@@ -247,10 +247,11 @@ The `wait` option tells Heya how long to wait before sending each message (the d
 Heya uses the following additional options to build the message itself:
 
 | Option Name | Default      | Description                |
-| :---------- | :----------- | :------------------------- |
+|-------------|--------------|----------------------------|
 | `subject`   | **required** | The email's subject        |
 | `from`      | Heya default | The sender's email address |
 | `layout`    | Heya default | The email's layout file    |
+| `to`        | See below    | See below                  |
 
 You can change the default options using the `default` method at the top of the campaign. Heya applies default options to each step which doesn't supply its own:
 
@@ -268,6 +269,27 @@ class OnboardingCampaign < ApplicationCampaign
 end
 ```
 
+#### Customizing the `to` field
+
+You can customize the `to` field by passing a callable object, which Heya will invoke with the user. For instance:
+
+```ruby
+class OnboardingCampaign < ApplicationCampaign
+  step :welcome,
+    subject: "Welcome to my app!",
+    to: -> (user) { ActionMailer::Base.email_address_with_name(user.email, user.nickname) }
+end
+```
+
+It is recommended to rely on `ActionMailer::Base.email_address_with_name` so that sanitization is correctly applied.
+
+If the `to` param is not provided, Heya will default to:
+
+1. `user#first_name`
+1. `user#name`
+
+If the `user` object doesn't respond to these methods, it will fallback to a simple `user.email` in the `to` field.
+
 #### Quality control option
 
 You may wish to apply quality control to individual steps of a campaign. For example, when adding a new step to an existing campaign it is

data/app/mailers/heya/campaign_mailer.rb

@@ -2,6 +2,7 @@ module Heya
   class CampaignMailer < ApplicationMailer
     DEFAULT_LAYOUT = "heya/campaign_mailer"
     layout -> { params.fetch(:step).params.fetch("layout", DEFAULT_LAYOUT) }
+    include Rails.application.routes.url_helpers
 
     def build
       user = params.fetch(:user)
@@ -26,7 +27,7 @@ module Heya
         from: from,
         bcc: bcc,
         reply_to: reply_to,
-        to: user.email,
+        to: to_address(user, step),
         subject: subject,
         template_path: "heya/campaign_mailer/#{campaign_name}",
         template_name: step_name
@@ -52,5 +53,27 @@ module Heya
         end
       end
     end
+
+    def to_address(user, step)
+      return step.params["to"].call(user) if step.params["to"].respond_to?(:call)
+
+      if user.respond_to?(:first_name)
+        self.class.email_address_with_name(user.email, user.first_name)
+      elsif user.respond_to?(:name)
+        self.class.email_address_with_name(user.email, user.name)
+      else
+        user.email
+      end
+    end
+
+    # This method is a backport and can be removed when we drop support of
+    # Rails 6.0; As of Rails 6.1, ActionMailer::Base, which we inherit from,
+    # already includes it.
+    def self.email_address_with_name(address, name)
+      Mail::Address.new.tap do |builder|
+        builder.address = address
+        builder.display_name = name
+      end.to_s
+    end
   end
 end

data/lib/heya/campaigns/actions/email.rb

@@ -4,7 +4,7 @@ module Heya
   module Campaigns
     module Actions
       class Email < Action
-        VALID_PARAMS = %w[subject from reply_to bcc layout]
+        VALID_PARAMS = %w[subject from reply_to bcc layout to]
 
         def self.validate_step(step)
           step.params.assert_valid_keys(VALID_PARAMS)

data/lib/heya/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Heya
-  VERSION = "0.6.1"
+  VERSION = "0.7.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: heya
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Joshua Wood
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-01-05 00:00:00.000000000 Z
+date: 2022-02-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -131,7 +131,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
+rubygems_version: 3.3.3
 signing_key:
 specification_version: 4
 summary: "Heya \U0001F44B"