belt-messaging 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 66741e509a64ee8df126ea2f5ddefc6b84c6ad544dcb5528be839c6f2a31556f
-  data.tar.gz: d7d4e424fed7aca6be6c7917fb8fa9de87e92fd6b6b0f69b839ba73b3056966d
+  metadata.gz: e3f46b8a5c65296c353f37726532835ef2c4b65a988861f8d6c26efbf433a7d8
+  data.tar.gz: 64d9a505cfd10b21c606f78e7cea5c208147c6857bad19629e2a0b307e24a659
 SHA512:
-  metadata.gz: cdca528c94667c4fd4dfb4071c3aa5a132dc016d39c668c9d1daa328cbf1290cecada794620dab4940632d8522a699e9eebb8653089eb107f79b67c208630577
-  data.tar.gz: 6d2f2ba6f8cf82c88c669508910e9b22cbe7f21c4753036c2df13ee11f658294be1f3170e3add197e0a0af4625e50113d287581b1a09f19828c00881bf52e022
+  metadata.gz: 217d18276f86e6efd68ae4149a105a01e1a4d541afea332f22fd1e132dd1d39dbc0c21f01ecc16dc45637c30d5d6f6b7d4a809d74e6144adfd07eba465a7f289
+  data.tar.gz: 5b5161710702b061b8739c8145a2c92f2023958c73742a20a9bca90c51f1c5ac50582380e98d23da7f09a72fbcf4a9e74aabb0ca590b8f60f761a502eaba8eac

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.2.0
+
+- `Belt::Messaging.send_email` accepts `headers:` (Hash of extra message headers) and `reply_to:` (String or Array). Headers go through SESv2 simple content, so you can set `List-Unsubscribe` + `List-Unsubscribe-Post: List-Unsubscribe=One-Click` (RFC 8058) and get the Gmail/Yahoo one-click unsubscribe button. Invalid reply-to addresses reject the send, same as invalid recipients.
+- Require `aws-sdk-sesv2 ~> 1.45` (first release with SendEmail custom headers).
+
 ## 0.1.1
 
 - Fix Terraform `email_send` IAM policy failing to apply on a fresh deploy: its `count` was gated on the SES identity ARN, a computed attribute unknown until apply, which raised `Invalid count argument`. Gate the policy document, policy resource, and `email_send_policy_arn` output on a plan-time-known local derived from input variables instead. Without this, the Lambda role never received `ses:SendEmail` and outbound transactional email silently never sent.

data/README.md

@@ -44,6 +44,18 @@ Belt::Messaging.send_email(
   html: '<h1>Weekly Update</h1><p>HTML version...</p>'
 )
 
+# Reply-To and custom headers (e.g. RFC 8058 one-click unsubscribe)
+Belt::Messaging.send_email(
+  to: 'user@example.com',
+  subject: 'You were invited',
+  body: 'Join us... Stop these emails: https://example.com/unsub?t=abc',
+  reply_to: 'support@example.com',
+  headers: {
+    'List-Unsubscribe' => '<https://example.com/unsub?t=abc>',
+    'List-Unsubscribe-Post' => 'List-Unsubscribe=One-Click'
+  }
+)
+
 # Phone number utilities
 Belt::Messaging::PhoneFormatter.format_e164('(555) 123-4567') #=> '+15551234567'
 Belt::Messaging::PhoneFormatter.valid?('555-123-4567')         #=> true

data/lib/belt/messaging/email.rb

@@ -20,8 +20,12 @@ module Belt
       # @param body [String] Email body (plain text)
       # @param html [String, nil] Optional HTML body
       # @param from [String, nil] Override the configured from address
+      # @param reply_to [String, Array<String>, nil] Reply-To address(es)
+      # @param headers [Hash{String => String}] Extra message headers, e.g.
+      #   { 'List-Unsubscribe' => '<https://example.com/unsub?t=abc>',
+      #     'List-Unsubscribe-Post' => 'List-Unsubscribe=One-Click' }
       # @return [Boolean] true if sent successfully, false otherwise
-      def self.send(to:, subject:, body:, html: nil, from: nil)
+      def self.send(to:, subject:, body:, html: nil, from: nil, reply_to: nil, headers: {})
         config = Belt::Messaging.configuration
 
         unless config.email_enabled?
@@ -48,6 +52,13 @@ module Belt
           return false
         end
 
+        reply_to_addresses = Array(reply_to)
+        invalid_reply_to = reply_to_addresses.reject { |email| valid_email?(email) }
+        if invalid_reply_to.any?
+          log(:error, 'Invalid reply-to address format', invalid: invalid_reply_to)
+          return false
+        end
+
         from_address = from || config.email_from_address
         if from_address.nil? || from_address.empty?
           log(:error, 'EMAIL_FROM_ADDRESS not configured')
@@ -57,13 +68,16 @@ module Belt
         begin
           client = Aws::SESV2::Client.new(region: config.aws_region)
 
-          email_content = build_email_content(subject, body, html)
+          email_content = build_email_content(subject, body, html, headers)
 
-          client.send_email({
+          params = {
             from_email_address: from_address,
             destination: { to_addresses: recipients },
             content: { simple: email_content }
-          })
+          }
+          params[:reply_to_addresses] = reply_to_addresses if reply_to_addresses.any?
+
+          client.send_email(params)
 
           log(:info, 'Email sent successfully', to: recipients, subject: subject)
           true
@@ -91,7 +105,7 @@ module Belt
         email.match?(/\A[^@\s]+@[^@\s]+\.[^@\s]+\z/)
       end
 
-      def self.build_email_content(subject, body, html)
+      def self.build_email_content(subject, body, html, headers)
         content = {
           subject: { data: subject, charset: 'UTF-8' },
           body: {
@@ -99,6 +113,9 @@ module Belt
           }
         }
         content[:body][:html] = { data: html, charset: 'UTF-8' } if html
+        if headers && !headers.empty?
+          content[:headers] = headers.map { |name, value| { name: name.to_s, value: value.to_s } }
+        end
         content
       end
       private_class_method :build_email_content

data/lib/belt/messaging/version.rb

@@ -2,6 +2,6 @@
 
 module Belt
   module Messaging
-    VERSION = '0.1.1'
+    VERSION = '0.2.0'
   end
 end

data/lib/belt/messaging.rb

@@ -49,9 +49,12 @@ module Belt
       # @param body [String] Email body (plain text)
       # @param html [String, nil] Optional HTML body
       # @param from [String, nil] Override configured from address
+      # @param reply_to [String, Array<String>, nil] Reply-To address(es)
+      # @param headers [Hash{String => String}] Extra message headers (e.g. List-Unsubscribe)
       # @return [Boolean] true if sent successfully
-      def send_email(to:, subject:, body:, html: nil, from: nil)
-        Email.send(to: to, subject: subject, body: body, html: html, from: from)
+      def send_email(to:, subject:, body:, html: nil, from: nil, reply_to: nil, headers: {})
+        Email.send(to: to, subject: subject, body: body, html: html, from: from,
+                   reply_to: reply_to, headers: headers)
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: belt-messaging
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Stowzilla
@@ -43,14 +43,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.45'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.45'
 description: Belt plugin providing SMS and email messaging. SMS via AWS PinpointSMSVoiceV2,
   email via AWS SESv2. Includes phone verification, opt-in/opt-out handling, and Terraform
   infrastructure.