aws-actionmailer-ses 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ec867bd416f2def54b5dda14e9f3621ae8874dbaab3915c8931f81d3a3483f6e
-  data.tar.gz: 72507e750b1240ec40675098c025d0825d55c690f1b7dc6e0839060d979ae3cb
+  metadata.gz: e84d63cd92cc606c4436f3f34e07e79c422b3a46f05b405ae7f2b774431781f1
+  data.tar.gz: b02a20505f08ecc019dd160be181eafb9b1a64567bc7abce2f8a9b26c06e631f
 SHA512:
-  metadata.gz: 997665131266a6d065c0e4fa55f10e0d376812a1c8a1e636948141bc75f30f0337291bddac00058333ad8b59da851deabea768179f73a9d4393b1c2a61f855d8
-  data.tar.gz: cf9adf87de27c4eaee187663c5aa00c96ad34558a727dc4e04579bd9e53668d2e79943c1d749ca6f8e8a9ef6afa047ee73c31e4b4826df6575fa6963a1a8cdb9
+  metadata.gz: fee74b70ebd190204cb83abd71e6e04b04f1495dc40f36b68fc746eaebb0c35feb48d681fb89bc185000c4c9aca48333882bf454889a8aed0cf2318f522a043e
+  data.tar.gz: 58692d241e18004f35b1054ceb9f28c73defb91e7f807e01dd464edde5c79bb3196bc1d9dff82bf2d2a0049df5c6e6560ac35fa238c86289691f88b13c5e3d53

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+1.2.0 (2026-05-21)
+------------------
+
+* Feature - Add support for `configuration_set_name` (#11), `email_tags` (#8), and `list_management_options` in SES V2 delivery settings.
+
 1.1.0 (2026-03-31)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.1.0
+1.2.0

data/lib/aws/action_mailer/ses_v2/mailer.rb

@@ -7,18 +7,45 @@ module Aws
     module SESV2
       # Provides a delivery method for ActionMailer that uses Amazon Simple Email Service V2.
       #
-      # Delivery settings are used to construct a new `Aws::SESV2::Client` instance.
       # Once you have a delivery method, you can configure your Rails environment to use it:
       #
       #     config.action_mailer.delivery_method = :ses_v2
       #     config.action_mailer.ses_v2_settings = { region: 'us-west-2' }
       #
-      # Alternatively, you could pass the client itself.
+      # You may also pass a preconstructed client:
       #
-      # The passed in client will be prioritized regardless of other `:ses_v2_settings` given.
+      #     sesv2_client = Aws::SESV2::Client.new(region: 'us-west-2')
+      #     config.action_mailer.ses_v2_settings = { sesv2_client: sesv2_client }
+      #
+      # == SendEmail Options
+      #
+      # Settings in {SEND_EMAIL_KEYS} are forwarded directly to the
+      # {https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SESV2/Client.html#send_email-instance_method SendEmail}
+      # API call rather than to the client constructor. They can be configured at
+      # any level:
+      #
+      #     # Global (all emails)
+      #     config.action_mailer.ses_v2_settings = {
+      #       region: 'us-west-2',
+      #       configuration_set_name: 'Production'
+      #     }
+      #
+      #     # Per-mailer class
+      #     class MarketingMailer < ApplicationMailer
+      #       default delivery_method_options: {
+      #         configuration_set_name: 'Marketing',
+      #         list_management_options: { contact_list_name: 'Promos', topic_name: 'Weekly' }
+      #       }
+      #     end
       #
       # @see https://guides.rubyonrails.org/action_mailer_basics.html
       class Mailer
+        SEND_EMAIL_KEYS = %i[
+          configuration_set_name
+          email_tags
+          list_management_options
+        ].freeze
+
         attr_reader :settings
 
         # @param [Hash] settings
@@ -26,16 +53,31 @@ module Aws
         #   You may pass `:sesv2_client` with a preconstructed {Aws::SESV2::Client} to reuse
         #   an existing instance (e.g. to avoid credential resolution on every delivery).
         #   When provided, the injected client is used and all other options are ignored.
+        #
+        #   The following keys are extracted from settings and forwarded as parameters
+        #   to the [SendEmail](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SESV2/Client.html#send_email-instance_method)
+        #   API call (they are not passed to the client constructor):
+        #
+        #   * `:configuration_set_name` - The name of the configuration set to use for this message.
+        #   * `:email_tags` - A list of message tags ({Types::MessageTag} hashes).
+        #   * `:list_management_options` - A {Types::ListManagementOptions} hash for SES
+        #     subscription management.
+        #
         def initialize(settings = {})
           @settings = settings
+          @send_email_params = {}
           client_settings = settings.dup
+          SEND_EMAIL_KEYS.each do |key|
+            value = client_settings.delete(key)
+            @send_email_params[key] = value if value
+          end
           @client = client_settings.delete(:sesv2_client) || Aws::SESV2::Client.new(client_settings)
 
           update_user_agent
         end
 
         # Delivers a Mail::Message object. Called during mail delivery.
-        def deliver!(message)
+        def deliver!(message) # rubocop:disable Metrics/MethodLength
           params = { content: { raw: { data: message.to_s } } }
           params[:from_email_address] = from_email_address(message)
           params[:destination] = {
@@ -43,6 +85,7 @@ module Aws
             cc_addresses: message.cc,
             bcc_addresses: message.bcc
           }
+          params.merge!(@send_email_params)
 
           @client.send_email(params).tap do |response|
             message.header[:ses_message_id] = response.message_id

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-actionmailer-ses
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Amazon Web Services
@@ -80,7 +80,10 @@ files:
 homepage: https://github.com/aws/aws-actionmailer-ses-ruby
 licenses:
 - Apache-2.0
-metadata: {}
+metadata:
+  source_code_uri: https://github.com/aws/aws-actionmailer-ses-ruby
+  changelog_uri: https://github.com/aws/aws-actionmailer-ses-ruby/blob/main/CHANGELOG.md
+  documentation_uri: https://docs.aws.amazon.com/sdk-for-ruby/aws-actionmailer-ses/api/
 rdoc_options: []
 require_paths:
 - lib
@@ -95,7 +98,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.6
 specification_version: 4
 summary: ActionMailer integration with SES
 test_files: []