heya 0.5.1 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d6e0b9d8f683a3fa919bd5cdd2574d5894c334937e963512eab4ee8bc54b42a5
-  data.tar.gz: d0a207668ad43fcd6750860a0af85a131ee8b8b168c082c5c2919cc49ad9aa9a
+  metadata.gz: cc54010af38a9f2e0e58358f998ad7b81480955416bac5ae1a18c9b5dfdfecd3
+  data.tar.gz: ef7dbf811f3fec3c2e10e1d569f82aed0ae3309291f21a196c3dd43d28e7bf8e
 SHA512:
-  metadata.gz: fd07083120bbf4110fd60b8661dc4d0e4fa7b0ecaf0d29c11a74a6e68589dc06e12be2efe8ccacfcf924313006342cb9e413878e83bf6cd32df18d0a07c6c194
-  data.tar.gz: 17636d925028392b6ba153142d7f5513578fb3364d9b39eb3cd74cc0fcbbfcec454b2ece88ba4344e5344fb9ebc78461b200b8446eb8d1cdf6278c55177a4a72
+  metadata.gz: 76e3d5d214c06a53cd03c388682e5c22984c874f56e73c1ebf321b08f011fd513f2402fa4e05d6abea9fe7e705f0d1330645e38de86a541210431370ec2ec71a
+  data.tar.gz: ac526b113dc81c207e7a26783b7ae63db6ccba85a2588906277eb7eaeda627930037fd195dd23c110b753fe961723b885f19d03f4f0f5a203031d18638ec53a3

data/CHANGELOG.md

@@ -5,6 +5,24 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+
+## [0.6.1] - 2022-01-05
+### Fixed
+- Support Rails 7 (#151, @800a7b32)
+
+## [0.6.0] - 2021-11-02
+### Added
+- Optional `layout` parameter for steps; allowing override from default `heya/campaign_mailer`
+
+## [0.5.3] - 2021-08-18
+### Added
+- Create `bcc:` optional parameter for steps; use case is quality control
+
+## [0.5.2] - 2021-08-11
+### Fixed
+- Fix typo in initializer (#139, @800a7b32)
+
+## [0.5.1] - 2021-07-13
 ### Fixed
 - Fix compatibility with Rails 6.1.4 (introduced by [this change](https://github.com/rails/rails/commit/99049262d37fedcd25af91231423103b0d218694#diff-79b53b2602bf702bdd8ce677e096be6a6923a54236e17237c16068a510078683) to `build_arel`) (#137, @retsef)
 

data/README.md

@@ -250,9 +250,29 @@ Heya uses the following additional options to build the message itself:
 | :---------- | :----------- | :------------------------- |
 | `subject`   | **required** | The email's subject        |
 | `from`      | Heya default | The sender's email address |
+| `layout`    | Heya default | The email's layout file    |
 
 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:
 
+```ruby
+class OnboardingCampaign < ApplicationCampaign
+  default wait: 1.day,
+    queue: "onboarding",
+    from: "support@example.com",
+    layout: "onboarding"
+
+  # Will still be sent after one day from the
+  # email address support@example.com
+  step :welcome,
+    subject: "Welcome to my app!"
+end
+```
+
+#### 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
+a good idea to inspect real-time results in production. You can do this by using the `bcc:` step option, which would look like this:
+
 ```ruby
 class OnboardingCampaign < ApplicationCampaign
   default wait: 1.day,
@@ -263,6 +283,10 @@ class OnboardingCampaign < ApplicationCampaign
   # email address support@example.com
   step :welcome,
     subject: "Welcome to my app!"
+
+  step :added_two_months_later,
+    subject: "We now have something new to say!",
+    bcc: 'quality_control@example.com'
 end
 ```
 

data/app/mailers/heya/campaign_mailer.rb

@@ -1,6 +1,7 @@
 module Heya
   class CampaignMailer < ApplicationMailer
-    layout "heya/campaign_mailer"
+    DEFAULT_LAYOUT = "heya/campaign_mailer"
+    layout -> { params.fetch(:step).params.fetch("layout", DEFAULT_LAYOUT) }
 
     def build
       user = params.fetch(:user)
@@ -10,6 +11,7 @@ module Heya
       step_name = step.name.underscore
 
       from = step.params.fetch("from")
+      bcc = step.params.fetch("bcc", nil)
       reply_to = step.params.fetch("reply_to", nil)
 
       subject = step.params.fetch("subject") {
@@ -22,6 +24,7 @@ module Heya
 
       mail(
         from: from,
+        bcc: bcc,
         reply_to: reply_to,
         to: user.email,
         subject: subject,

data/lib/generators/heya/install/templates/initializer.rb.tt

@@ -8,7 +8,7 @@ Heya.configure do |config|
   # Campaign priority. When a user is added to multiple campaigns, they are
   # sent in this order. Campaigns are sent in the order that the users were
   # added if no priority is configured.
-  # config.campaings.priority = [
+  # config.campaigns.priority = [
   #   "FirstCampaign",
   #   "SecondCampaign",
   #   "ThirdCampaign"

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]
+        VALID_PARAMS = %w[subject from reply_to bcc layout]
 
         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.5.1"
+  VERSION = "0.6.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: heya
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.6.1
 platform: ruby
 authors:
 - Joshua Wood
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-07-13 00:00:00.000000000 Z
+date: 2022-01-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -19,7 +19,7 @@ dependencies:
         version: 5.2.3
     - - "<"
       - !ruby/object:Gem::Version
-        version: 6.2.0
+        version: 7.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: 5.2.3
     - - "<"
       - !ruby/object:Gem::Version
-        version: 6.2.0
+        version: 7.1.0
 - !ruby/object:Gem::Dependency
   name: pg
   requirement: !ruby/object:Gem::Requirement
@@ -131,7 +131,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
+rubygems_version: 3.2.22
 signing_key:
 specification_version: 4
 summary: "Heya \U0001F44B"