aws-actionmailer-ses 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d5155bf8bc7c5caf160e77e7768a0029fe7514e7d33d9ab14544072e64bb96cf
-  data.tar.gz: a281ec02f365a903eade4ef008fde838b5748100211b3e2fa37aac1909d9dcff
+  metadata.gz: ec867bd416f2def54b5dda14e9f3621ae8874dbaab3915c8931f81d3a3483f6e
+  data.tar.gz: 72507e750b1240ec40675098c025d0825d55c690f1b7dc6e0839060d979ae3cb
 SHA512:
-  metadata.gz: c865beacd6615da65f966d7e89cf145bf301d72babec69915c7a1e74c277048d2005c86634857156f71088a37898623c8349a90f5cddd77ce20c1a38735f9ae3
-  data.tar.gz: 2d4ebed009cc45470df4b4ab9c2258dbc8737ec00b885c34abc7b0f570165cb26f01b597c737e4cef5b206563442333f1bc02c2fac4725b78a8a7a23648e68ab
+  metadata.gz: 997665131266a6d065c0e4fa55f10e0d376812a1c8a1e636948141bc75f30f0337291bddac00058333ad8b59da851deabea768179f73a9d4393b1c2a61f855d8
+  data.tar.gz: cf9adf87de27c4eaee187663c5aa00c96ad34558a727dc4e04579bd9e53668d2e79943c1d749ca6f8e8a9ef6afa047ee73c31e4b4826df6575fa6963a1a8cdb9

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+1.1.0 (2026-03-31)
+------------------
+
+* Feature - Support injecting a preconstructed client via `:ses_client` and `:sesv2_client` options.
+
 1.0.0 (2024-11-21)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.0.0
+1.1.0

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

@@ -7,22 +7,31 @@ module Aws
     module SES
       # Provides a delivery method for ActionMailer that uses Amazon Simple Email Service.
       #
-      # Delivery settings are used to construct a new Aws::SES::Client instance.
+      # Delivery settings are used to construct a new `Aws::SES::Client` instance.
       # Once you have a delivery method, you can configure your Rails environment to use it:
       #
       #     config.action_mailer.delivery_method = :ses
       #     config.action_mailer.ses_settings = { region: 'us-west-2' }
       #
+      # Alternatively, you could pass the client itself.
+      #
+      # The passed in client will be prioritized regardless of other `:ses_settings` given.
+      #
       # @see https://guides.rubyonrails.org/action_mailer_basics.html
       class Mailer
         attr_reader :settings
 
-        # @param [Hash] settings Passes along initialization options to
-        #   [Aws::SES::Client.new](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SES/Client.html#initialize-instance_method).
+        # @param [Hash] settings
+        #   Passes along initialization options to [Aws::SES::Client.new](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SES/Client.html#initialize-instance_method).
+        #   You may pass `:ses_client` with a preconstructed {Aws::SES::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.
         def initialize(settings = {})
           @settings = settings
-          @client = Aws::SES::Client.new(settings)
-          @client.config.user_agent_frameworks << 'aws-actionmailer-ses'
+          client_settings = settings.dup
+          @client = client_settings.delete(:ses_client) || Aws::SES::Client.new(client_settings)
+
+          update_user_agent
         end
 
         # Delivers a Mail::Message object. Called during mail delivery.
@@ -36,6 +45,14 @@ module Aws
             message.header[:ses_message_id] = response.message_id
           end
         end
+
+        private
+
+        def update_user_agent
+          return if @client.config.user_agent_frameworks.include?('aws-actionmailer-ses')
+
+          @client.config.user_agent_frameworks << 'aws-actionmailer-ses'
+        end
       end
     end
   end

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

@@ -7,22 +7,31 @@ 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.
+      # 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.
+      #
+      # The passed in client will be prioritized regardless of other `:ses_v2_settings` given.
+      #
       # @see https://guides.rubyonrails.org/action_mailer_basics.html
       class Mailer
         attr_reader :settings
 
-        # @param [Hash] settings Passes along initialization settings to
-        #   [Aws::SESV2::Client.new](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SESV2/Client.html#initialize-instance_method).
+        # @param [Hash] settings
+        #   Passes along initialization settings to [Aws::SESV2::Client.new](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SESV2/Client.html#initialize-instance_method).
+        #   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.
         def initialize(settings = {})
           @settings = settings
-          @client = Aws::SESV2::Client.new(settings)
-          @client.config.user_agent_frameworks << 'aws-actionmailer-ses'
+          client_settings = settings.dup
+          @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.
@@ -42,6 +51,12 @@ module Aws
 
         private
 
+        def update_user_agent
+          return if @client.config.user_agent_frameworks.include?('aws-actionmailer-ses')
+
+          @client.config.user_agent_frameworks << 'aws-actionmailer-ses'
+        end
+
         # smtp_envelope_from will default to the From address *without* sender names.
         # By omitting this param, SESv2 will correctly use sender names from the mail headers.
         # We should only use smtp_envelope_from when it was explicitly set (instance variable set)

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: aws-actionmailer-ses
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Amazon Web Services
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-21 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-ses
@@ -82,7 +81,6 @@ homepage: https://github.com/aws/aws-actionmailer-ses-ruby
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -97,8 +95,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: ActionMailer integration with SES
 test_files: []