mailtrap 1.2.2 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c02915dc1ea123fb592af56b9c553cb97e6137f0555b98f965f3a8cf1dd1d229
-  data.tar.gz: 8e7da7be2313f3e3766512e5c4014f90d1f8f1ddb271cbd255494252b6eda161
+  metadata.gz: 5423fd6ba2817ace06e724da478e925615f3c8b4dfcbf24eb271f6bb12fded4c
+  data.tar.gz: b331be242b93d7176adf0ca92d01f33d0bc7a9407766d8d139d8bb39d7d2382b
 SHA512:
-  metadata.gz: 962e1a2227a79b264bd637f643ffbf326c03d56ba1736a406869fda693eb67c5ffed3797cacd1862403e034ba543c44094829fe45ec36c6fcfa2e96ecdd554c3
-  data.tar.gz: b568ff9976cba7311ae02118bbbe5b825230743facd0094921fa3ac58d4fe4d8132c9b9bbc5dca4c6d60fc798fa18d8508149a871949de971e621af50c386177
+  metadata.gz: 9c2556e7ea3b7405ec76910a718ba949694563dabc4547fc6b33771bd52a2bd0e444e287bcc341c6c5e1bdab07bd12573c3ce9607cbcc84afbd8398aafbccf4c
+  data.tar.gz: 06f0ea3e473461ad889e101540ba2d2a37cfda75ce3a4677ab58708ddae8ce4cae53d16426f4b30e54bf899e9a5f3cca0c46e0616c49b9da80be9c1e8c308c67

data/.rubocop.yml

@@ -1,10 +1,16 @@
-require: rubocop-rspec
+require:
+  - rubocop-rake
+  - rubocop-rspec
+
+inherit_mode:
+  merge:
+    - Exclude
 
 AllCops:
-  TargetRubyVersion: 2.7
+  TargetRubyVersion: 3.0
   NewCops: enable
   Exclude:
-    - 'gemfiles/**/*'
+    - "gemfiles/**/*"
 
 Layout/LineLength:
   Max: 120
@@ -31,3 +37,11 @@ Style/StringLiterals:
 Style/StringLiteralsInInterpolation:
   Enabled: true
   EnforcedStyle: double_quotes
+
+Style/FrozenStringLiteralComment:
+  Exclude:
+    - "examples/**/*"
+
+Style/TrailingCommaInHashLiteral:
+  Exclude:
+    - "examples/**/*"

data/.ruby-version

@@ -1 +1 @@
-2.7.6
+3.3.3

data/CHANGELOG.md

@@ -1,3 +1,24 @@
+## [2.1.0] - 2024-07-08
+
+- Fixed extraneous headers added by ActionMailer #21
+- Dropped Ruby 2.7 support and added test coverage for Ruby up to 3.3 #22
+
+## [2.0.0] - 2024-03-20
+
+- Added arguments for `Mailtrap::Client`
+  - `bulk` to use Mailtrap bulk sending API
+  - `sandbox` to use Mailtrap sandbox API
+  - `inbox_id` required when using Mailtrap sandbox API
+
+- Removed Sending namespace, affected classes:
+  - `Mailtrap::Sending::Client` -> `Mailtrap::Client`
+  - `Mailtrap::Sending::Error` -> `Mailtrap::Error`
+  - `Mailtrap::Sending::AttachmentContentError` -> `Mailtrap::AttachmentContentError`
+  - `Mailtrap::Sending::AuthorizationError` -> `Mailtrap::AuthorizationError`
+  - `Mailtrap::Sending::MailSizeError` -> `Mailtrap::MailSizeError`
+  - `Mailtrap::Sending::RateLimitError` -> `Mailtrap::RateLimitError`
+  - `Mailtrap::Sending::RejectionError` -> `Mailtrap::RejectionError`
+
 ## [1.2.2] - 2023-11-01
 
 - Improved error handling

data/Gemfile

@@ -11,6 +11,7 @@ gem 'rake', '~> 13.0'
 gem 'rspec', '~> 3.0'
 gem 'rspec-its'
 gem 'rubocop', '~> 1.21'
+gem 'rubocop-rake', require: false
 gem 'rubocop-rspec', require: false
 gem 'vcr'
 gem 'webmock'

data/Gemfile.lock

@@ -1,68 +1,93 @@
 PATH
   remote: .
   specs:
-    mailtrap (1.2.2)
+    mailtrap (2.1.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.8.0)
-      public_suffix (>= 2.0.2, < 5.0)
-    appraisal (2.4.1)
+    addressable (2.8.7)
+      public_suffix (>= 2.0.2, < 7.0)
+    appraisal (2.5.0)
       bundler
       rake
       thor (>= 0.14.0)
     ast (2.4.2)
-    crack (0.4.5)
+    bigdecimal (3.1.8)
+    crack (1.0.0)
+      bigdecimal
       rexml
-    diff-lcs (1.5.0)
-    hashdiff (1.0.1)
-    mail (2.7.1)
+    date (3.3.4)
+    diff-lcs (1.5.1)
+    hashdiff (1.1.0)
+    json (2.7.2)
+    language_server-protocol (3.17.0.3)
+    mail (2.8.1)
       mini_mime (>= 0.1.1)
-    mini_mime (1.1.2)
-    net-smtp (0.1.0)
-    parallel (1.22.1)
-    parser (3.1.2.0)
+      net-imap
+      net-pop
+      net-smtp
+    mini_mime (1.1.5)
+    net-imap (0.4.14)
+      date
+      net-protocol
+    net-pop (0.1.2)
+      net-protocol
+    net-protocol (0.2.2)
+      timeout
+    net-smtp (0.5.0)
+      net-protocol
+    parallel (1.25.1)
+    parser (3.3.3.0)
       ast (~> 2.4.1)
-    public_suffix (4.0.7)
+      racc
+    public_suffix (5.1.1)
+    racc (1.8.0)
     rainbow (3.1.1)
-    rake (13.0.6)
-    regexp_parser (2.4.0)
-    rexml (3.2.5)
-    rspec (3.11.0)
-      rspec-core (~> 3.11.0)
-      rspec-expectations (~> 3.11.0)
-      rspec-mocks (~> 3.11.0)
-    rspec-core (3.11.0)
-      rspec-support (~> 3.11.0)
-    rspec-expectations (3.11.0)
+    rake (13.2.1)
+    regexp_parser (2.9.2)
+    rexml (3.3.1)
+      strscan
+    rspec (3.13.0)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.0)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.11.0)
+      rspec-support (~> 3.13.0)
     rspec-its (1.3.0)
       rspec-core (>= 3.0.0)
       rspec-expectations (>= 3.0.0)
-    rspec-mocks (3.11.1)
+    rspec-mocks (3.13.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.11.0)
-    rspec-support (3.11.0)
-    rubocop (1.29.1)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.1)
+    rubocop (1.64.1)
+      json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
-      parser (>= 3.1.0.0)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.17.0, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 3.0)
-    rubocop-ast (1.18.0)
-      parser (>= 3.1.1.0)
-    rubocop-rspec (2.11.1)
-      rubocop (~> 1.19)
-    ruby-progressbar (1.11.0)
-    thor (1.2.1)
-    unicode-display_width (2.1.0)
-    vcr (6.1.0)
-    webmock (3.14.0)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.31.3)
+      parser (>= 3.3.1.0)
+    rubocop-rake (0.6.0)
+      rubocop (~> 1.0)
+    rubocop-rspec (3.0.2)
+      rubocop (~> 1.61)
+    ruby-progressbar (1.13.0)
+    strscan (3.1.0)
+    thor (1.3.1)
+    timeout (0.4.1)
+    unicode-display_width (2.5.0)
+    vcr (6.2.0)
+    webmock (3.23.1)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
@@ -79,9 +104,10 @@ DEPENDENCIES
   rspec (~> 3.0)
   rspec-its
   rubocop (~> 1.21)
+  rubocop-rake
   rubocop-rspec
   vcr
   webmock
 
 BUNDLED WITH
-   2.1.4
+   2.5.14

data/README.md

@@ -6,6 +6,8 @@ This Ruby gem offers integration with the [official API](https://api-docs.mailtr
 
 Quickly add email sending functionality to your Ruby application with Mailtrap.
 
+(This client uses API v2, for v1 refer to [this documentation](https://mailtrap.docs.apiary.io/))
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -40,97 +42,17 @@ mail = Mailtrap::Mail::Base.new(
 )
 
 # create client and send
-client = Mailtrap::Sending::Client.new(api_key: 'your-api-key')
+client = Mailtrap::Client.new(api_key: 'your-api-key')
 client.send(mail)
 ```
 
-### Full
+Refer to the [`examples`](examples) folder for other examples.
 
-```ruby
-require 'mailtrap'
-require 'base64'
+- [Full](examples/full.rb)
+- [Email template](examples/email_template.rb)
+- [ActionMailer](examples/action_mailer.rb)
 
-mail = Mailtrap::Mail::Base.new(
-  from: { email: 'mailtrap@example.com', name: 'Mailtrap Test' },
-  to: [
-    { email: 'your@email.com', name: 'Your name' }
-  ],
-  cc: [
-    { email: 'cc@email.com', name: 'Copy To' }
-  ],
-  bcc: [
-    { email: 'bcc@email.com', name: 'Hidden Recipient' }
-  ],
-  subject: 'You are awesome!',
-  text: "Congrats for sending test email with Mailtrap!",
-  category: "Integration Test",
-  attachments: [
-    {
-      content: Base64.encode64('Attachment content'), # base64 encoded content or IO string
-      filename: 'attachment.txt'
-    }
-  ],
-  headers: {
-    'X-MT-Header': 'Custom header'
-  },
-  custom_variables: {
-    year: 2022
-  }
-)
-
-data = File.open('/path/to/image.jpg').read
-encoded = Base64.encode64(data).gsub(/\n/,"")
-
-mail.add_attachment(content: encoded, filename: 'image.png')
-
-client = Mailtrap::Sending::Client.new(api_key: 'your-api-key')
-client.send(mail)
-```
-
-### Using email template
-
-```ruby
-require 'mailtrap'
-
-# create mail object
-mail = Mailtrap::Mail::FromTemplate.new(
-  from: { email: 'mailtrap@example.com', name: 'Mailtrap Test' },
-  to: [
-    { email: 'your@email.com' }
-  ],
-  template_uuid: '2f45b0aa-bbed-432f-95e4-e145e1965ba2',
-  template_variables: {
-    'user_name' => 'John Doe'
-  }
-)
-
-# create client and send
-client = Mailtrap::Sending::Client.new(api_key: 'your-api-key')
-client.send(mail)
-```
-
-### ActionMailer
-
-This gem also adds ActionMailer delivery method. To configure it, add following to your ActionMailer configuration (in Rails projects located in `config/$ENVIRONMENT.rb`):
-```ruby
-config.action_mailer.delivery_method = :mailtrap
-config.action_mailer.mailtrap_settings = {
-  api_key: ENV.fetch('MAILTRAP_API_KEY')
-}
-```
-And continue to use ActionMailer as usual.
-
-To add `category` and `custom_variables`, add them to the mail generation:
-```ruby
-mail(
-  to: 'your@email.com',
-  subject: 'You are awesome!',
-  category: 'Test category',
-  custom_variables: { test_variable: 'abc' }
-)
-```
-
-#### Content-Transfer-Encoding
+### Content-Transfer-Encoding
 
 `mailtrap` gem uses Mailtrap API to send emails. Mailtrap API does not try to
 replicate SMTP. That is why you should expect some limitations when it comes to 
@@ -144,6 +66,12 @@ better flexibility in that regard. Go to your _Mailtrap account_ → _Email Send
 → _Sending Domains_ → _Your domain_ → _SMTP/API Settings_ to find the SMTP 
 configuration example.
 
+## Migration guide v1 → v2
+
+Change `Mailtrap::Sending::Client` to `Mailtrap::Client`.
+
+If you use classes which have `Sending` namespace, remove the namespace like in the example above.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/mailtrap/action_mailer/delivery_method.rb

@@ -5,6 +5,8 @@ module Mailtrap
     class DeliveryMethod
       attr_accessor :settings
 
+      ALLOWED_PARAMS = %i[api_key api_host api_port bulk sandbox inbox_id].freeze
+
       def initialize(settings)
         self.settings = settings
       end
@@ -18,7 +20,7 @@ module Mailtrap
       private
 
       def client
-        @client ||= Mailtrap::Sending::Client.new(**settings.slice(:api_key, :api_host, :api_port))
+        @client ||= Mailtrap::Client.new(**settings.slice(*ALLOWED_PARAMS))
       end
     end
   end

data/lib/mailtrap/attachment.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require 'base64'
+require 'json'
+
+module Mailtrap
+  class Attachment
+    attr_accessor :type, :filename, :disposition, :content_id
+    attr_reader :content
+
+    def initialize(content:, filename:, type: nil, disposition: nil, content_id: nil)
+      self.content = content
+      @type = type
+      @filename = filename
+      @disposition = disposition
+      @content_id = content_id
+    end
+
+    def as_json
+      {
+        'content' => content,
+        'type' => type,
+        'filename' => filename,
+        'disposition' => disposition,
+        'content_id' => content_id
+      }.compact
+    end
+
+    def content=(content)
+      if content.respond_to?(:read)
+        @content = encode(content)
+      else
+        raise AttachmentContentError unless base64?(content)
+
+        @content = content
+      end
+    end
+
+    private
+
+    def encode(io)
+      string = io.read.encode('UTF-8') unless io.respond_to?(:binmode?) && io.binmode?
+      Base64.encode64(string).gsub("\n", '')
+    end
+
+    def base64?(string)
+      string.is_a?(String) && Base64.strict_encode64(Base64.decode64(string)) == string
+    end
+  end
+end

data/lib/mailtrap/client.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'net/http'
+require 'uri'
+
+module Mailtrap
+  class Client
+    SENDING_API_HOST = 'send.api.mailtrap.io'
+    BULK_SENDING_API_HOST = 'bulk.api.mailtrap.io'
+    SANDBOX_API_HOST = 'sandbox.api.mailtrap.io'
+    API_PORT = 443
+
+    attr_reader :api_key, :api_host, :api_port, :bulk, :sandbox, :inbox_id
+
+    # Initializes a new Mailtrap::Client instance.
+    #
+    # @param [String] api_key The Mailtrap API key to use for sending. Required.
+    #                         If not set, is taken from the MAILTRAP_API_KEY environment variable.
+    # @param [String, nil] api_host The Mailtrap API hostname. If not set, is chosen internally.
+    # @param [Integer] api_port The Mailtrap API port. Default: 443.
+    # @param [Boolean] bulk Whether to use the Mailtrap bulk sending API. Default: false.
+    #                       If enabled, is incompatible with `sandbox: true`.
+    # @param [Boolean] sandbox Whether to use the Mailtrap sandbox API. Default: false.
+    #                          If enabled, is incompatible with `bulk: true`.
+    # @param [Integer] inbox_id The sandbox inbox ID to send to. Required if sandbox API is used.
+    def initialize( # rubocop:disable Metrics/ParameterLists
+      api_key: ENV.fetch('MAILTRAP_API_KEY'),
+      api_host: nil,
+      api_port: API_PORT,
+      bulk: false,
+      sandbox: false,
+      inbox_id: nil
+    )
+      raise ArgumentError, 'api_key is required' if api_key.nil?
+      raise ArgumentError, 'api_port is required' if api_port.nil?
+
+      api_host ||= select_api_host(bulk: bulk, sandbox: sandbox)
+      raise ArgumentError, 'inbox_id is required for sandbox API' if sandbox && inbox_id.nil?
+
+      @api_key = api_key
+      @api_host = api_host
+      @api_port = api_port
+      @bulk = bulk
+      @sandbox = sandbox
+      @inbox_id = inbox_id
+    end
+
+    def send(mail)
+      raise ArgumentError, 'should be Mailtrap::Mail::Base object' unless mail.is_a? Mail::Base
+
+      request = post_request(request_url, mail.to_json)
+      response = http_client.request(request)
+
+      handle_response(response)
+    end
+
+    private
+
+    def select_api_host(bulk:, sandbox:)
+      raise ArgumentError, 'bulk mode is not applicable for sandbox API' if bulk && sandbox
+
+      if sandbox
+        SANDBOX_API_HOST
+      elsif bulk
+        BULK_SENDING_API_HOST
+      else
+        SENDING_API_HOST
+      end
+    end
+
+    def request_url
+      "/api/send#{sandbox ? "/#{inbox_id}" : ""}"
+    end
+
+    def http_client
+      @http_client ||= Net::HTTP.new(api_host, api_port).tap { |client| client.use_ssl = true }
+    end
+
+    def post_request(path, body)
+      request = Net::HTTP::Post.new(path)
+      request.body = body
+      request['Authorization'] = "Bearer #{api_key}"
+      request['Content-Type'] = 'application/json'
+      request['User-Agent'] = 'mailtrap-ruby (https://github.com/railsware/mailtrap-ruby)'
+
+      request
+    end
+
+    def handle_response(response) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
+      case response
+      when Net::HTTPOK
+        json_response(response.body)
+      when Net::HTTPBadRequest
+        raise Mailtrap::Error, json_response(response.body)[:errors]
+      when Net::HTTPUnauthorized
+        raise Mailtrap::AuthorizationError, json_response(response.body)[:errors]
+      when Net::HTTPForbidden
+        raise Mailtrap::RejectionError, json_response(response.body)[:errors]
+      when Net::HTTPPayloadTooLarge
+        raise Mailtrap::MailSizeError, ['message too large']
+      when Net::HTTPTooManyRequests
+        raise Mailtrap::RateLimitError, ['too many requests']
+      when Net::HTTPClientError
+        raise Mailtrap::Error, ['client error']
+      when Net::HTTPServerError
+        raise Mailtrap::Error, ['server error']
+      else
+        raise Mailtrap::Error, ["unexpected status code=#{response.code}"]
+      end
+    end
+
+    def json_response(body)
+      JSON.parse(body, symbolize_names: true)
+    end
+  end
+end

data/lib/mailtrap/errors.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require_relative 'attachment'
+require_relative 'client'
+
+module Mailtrap
+  class AttachmentContentError < StandardError; end
+
+  class Error < StandardError
+    attr_reader :messages
+
+    def initialize(messages)
+      @messages = messages
+
+      super(messages.join(', '))
+    end
+  end
+
+  # AuthorizationError is raised when invalid token is used.
+  class AuthorizationError < Error; end
+
+  # MailSizeError is raised when mail is too large.
+  class MailSizeError < Error; end
+
+  # RateLimitError is raised when client performing too many requests.
+  class RateLimitError < Error; end
+
+  # RejectionError is raised when server refuses to process the request. Use
+  # error message to debug the problem.
+  #
+  # *Some* possible reasons:
+  #   * Account is banned
+  #   * Domain is not verified
+  class RejectionError < Error; end
+end

data/lib/mailtrap/mail/base.rb

@@ -59,11 +59,11 @@ module Mailtrap
       end
 
       def attachments=(attachments)
-        @attachments = attachments.map { |attachment| Mailtrap::Sending::Attachment.new(**attachment) }
+        @attachments = attachments.map { |attachment| Mailtrap::Attachment.new(**attachment) }
       end
 
       def add_attachment(content:, filename:, type: nil, disposition: nil, content_id: nil)
-        attachment = Mailtrap::Sending::Attachment.new(
+        attachment = Mailtrap::Attachment.new(
           content: content,
           filename: filename,
           type: type,

data/lib/mailtrap/mail.rb

@@ -26,7 +26,7 @@ module Mailtrap
 
       private
 
-      PROCESSED_HEADERS = %w[
+      SPECIAL_HEADERS = %w[
         from
         to
         cc
@@ -37,6 +37,19 @@ module Mailtrap
         contenttype
       ].freeze
 
+      # ActionMailer adds these headers by calling `Mail::Message#encoded`,
+      # as if the message is to be delivered via SMTP.
+      # Since the message will actually be generated on the Mailtrap side from its components,
+      # the headers are redundant and potentially conflicting, so we remove them.
+      ACTIONMAILER_ADDED_HEADERS = %w[
+        contenttransferencoding
+        date
+        messageid
+        mimeversion
+      ].freeze
+
+      HEADERS_TO_REMOVE = (SPECIAL_HEADERS + ACTIONMAILER_ADDED_HEADERS).freeze
+
       def address_list(header)
         header.respond_to?(:element) ? header.element : header&.address_list
       end
@@ -48,7 +61,7 @@ module Mailtrap
       def prepare_headers(message)
         message
           .header_fields
-          .reject { |header| PROCESSED_HEADERS.include?(header.name.downcase.delete('-')) }
+          .reject { |header| HEADERS_TO_REMOVE.include?(header.name.downcase.delete('-')) }
           .to_h { |header| [header.name, header.value] }
           .compact
       end

data/lib/mailtrap/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Mailtrap
-  VERSION = '1.2.2'
+  VERSION = '2.1.0'
 end

data/lib/mailtrap.rb

@@ -2,7 +2,7 @@
 
 require_relative 'mailtrap/action_mailer' if defined? ActionMailer
 require_relative 'mailtrap/mail'
-require_relative 'mailtrap/sending'
+require_relative 'mailtrap/errors'
 require_relative 'mailtrap/version'
 
 module Mailtrap; end

data/mailtrap.gemspec

@@ -12,7 +12,7 @@ Gem::Specification.new do |spec|
   spec.description = 'Official mailtrap.io API client'
   spec.homepage = 'https://github.com/railsware/mailtrap-ruby'
   spec.license = 'MIT'
-  spec.required_ruby_version = '>= 2.7.0'
+  spec.required_ruby_version = '>= 3.0.0'
 
   spec.metadata['homepage_uri'] = spec.homepage
   spec.metadata['source_code_uri'] = 'https://github.com/railsware/mailtrap-ruby'
@@ -23,7 +23,9 @@ Gem::Specification.new do |spec|
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject do |f|
-      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|github|travis|circleci)|appveyor)})
+      (f == __FILE__) || f.match(
+        %r{\A(?:(?:bin|test|spec|features|examples)/|\.(?:git|github|travis|circleci)|appveyor)}
+      )
     end
   end
   spec.require_paths = ['lib']

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mailtrap
 version: !ruby/object:Gem::Version
-  version: 1.2.2
+  version: 2.1.0
 platform: ruby
 authors:
 - Railsware Products Studio LLC
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-11-09 00:00:00.000000000 Z
+date: 2024-07-08 00:00:00.000000000 Z
 dependencies: []
 description: Official mailtrap.io API client
 email:
@@ -32,12 +32,12 @@ files:
 - lib/mailtrap/action_mailer.rb
 - lib/mailtrap/action_mailer/delivery_method.rb
 - lib/mailtrap/action_mailer/railtie.rb
+- lib/mailtrap/attachment.rb
+- lib/mailtrap/client.rb
+- lib/mailtrap/errors.rb
 - lib/mailtrap/mail.rb
 - lib/mailtrap/mail/base.rb
 - lib/mailtrap/mail/from_template.rb
-- lib/mailtrap/sending.rb
-- lib/mailtrap/sending/attachment.rb
-- lib/mailtrap/sending/client.rb
 - lib/mailtrap/version.rb
 - mailtrap.gemspec
 homepage: https://github.com/railsware/mailtrap-ruby
@@ -56,14 +56,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: 3.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
+rubygems_version: 3.5.11
 signing_key:
 specification_version: 4
 summary: Official mailtrap.io API client

data/lib/mailtrap/sending/attachment.rb

@@ -1,52 +0,0 @@
-# frozen_string_literal: true
-
-require 'base64'
-require 'json'
-
-module Mailtrap
-  module Sending
-    class Attachment
-      attr_accessor :type, :filename, :disposition, :content_id
-      attr_reader :content
-
-      def initialize(content:, filename:, type: nil, disposition: nil, content_id: nil)
-        self.content = content
-        @type = type
-        @filename = filename
-        @disposition = disposition
-        @content_id = content_id
-      end
-
-      def as_json
-        {
-          'content' => content,
-          'type' => type,
-          'filename' => filename,
-          'disposition' => disposition,
-          'content_id' => content_id
-        }.compact
-      end
-
-      def content=(content)
-        if content.respond_to?(:read)
-          @content = encode(content)
-        else
-          raise AttachmentContentError unless base64?(content)
-
-          @content = content
-        end
-      end
-
-      private
-
-      def encode(io)
-        string = io.read.encode('UTF-8') unless io.respond_to?(:binmode?) && io.binmode?
-        Base64.encode64(string).gsub(/\n/, '')
-      end
-
-      def base64?(string)
-        string.is_a?(String) && Base64.strict_encode64(Base64.decode64(string)) == string
-      end
-    end
-  end
-end

data/lib/mailtrap/sending/client.rb

@@ -1,74 +0,0 @@
-# frozen_string_literal: true
-
-require 'json'
-require 'net/http'
-require 'uri'
-
-module Mailtrap
-  module Sending
-    class Client
-      API_HOST = 'send.api.mailtrap.io'
-      API_PORT = 443
-
-      attr_reader :api_key, :api_host, :api_port
-
-      def initialize(api_key: ENV.fetch('MAILTRAP_API_KEY'), api_host: API_HOST, api_port: API_PORT)
-        @api_key = api_key
-        @api_host = api_host
-        @api_port = api_port
-      end
-
-      def send(mail)
-        raise ArgumentError, 'should be Mailtrap::Mail::Base object' unless mail.is_a? Mail::Base
-
-        request = post_request('/api/send', mail.to_json)
-        response = http_client.request(request)
-
-        handle_response(response)
-      end
-
-      private
-
-      def http_client
-        @http_client ||= Net::HTTP.new(api_host, api_port).tap { |client| client.use_ssl = true }
-      end
-
-      def post_request(path, body)
-        request = Net::HTTP::Post.new(path)
-        request.body = body
-        request['Authorization'] = "Bearer #{api_key}"
-        request['Content-Type'] = 'application/json'
-        request['User-Agent'] = 'mailtrap-ruby (https://github.com/railsware/mailtrap-ruby)'
-
-        request
-      end
-
-      def handle_response(response) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
-        case response
-        when Net::HTTPOK
-          json_response(response.body)
-        when Net::HTTPBadRequest
-          raise Mailtrap::Sending::Error, json_response(response.body)[:errors]
-        when Net::HTTPUnauthorized
-          raise Mailtrap::Sending::AuthorizationError, json_response(response.body)[:errors]
-        when Net::HTTPForbidden
-          raise Mailtrap::Sending::RejectionError, json_response(response.body)[:errors]
-        when Net::HTTPPayloadTooLarge
-          raise Mailtrap::Sending::MailSizeError, ['message too large']
-        when Net::HTTPTooManyRequests
-          raise Mailtrap::Sending::RateLimitError, ['too many requests']
-        when Net::HTTPClientError
-          raise Mailtrap::Sending::Error, ['client error']
-        when Net::HTTPServerError
-          raise Mailtrap::Sending::Error, ['server error']
-        else
-          raise Mailtrap::Sending::Error, ["unexpected status code=#{response.code}"]
-        end
-      end
-
-      def json_response(body)
-        JSON.parse(body, symbolize_names: true)
-      end
-    end
-  end
-end

data/lib/mailtrap/sending.rb

@@ -1,37 +0,0 @@
-# frozen_string_literal: true
-
-require_relative 'sending/attachment'
-require_relative 'sending/client'
-
-module Mailtrap
-  module Sending
-    class AttachmentContentError < StandardError; end
-
-    class Error < StandardError
-      attr_reader :messages
-
-      def initialize(messages)
-        @messages = messages
-
-        super(messages.join(', '))
-      end
-    end
-
-    # AuthorizationError is raised when invalid token is used.
-    class AuthorizationError < Error; end
-
-    # MailSizeError is raised when mail is too large.
-    class MailSizeError < Error; end
-
-    # RateLimitError is raised when client performing too many requests.
-    class RateLimitError < Error; end
-
-    # RejectionError is raised when server refuses to process the request. Use
-    # error message to debug the problem.
-    #
-    # *Some* possible reasons:
-    #   * Account is banned
-    #   * Domain is not verified
-    class RejectionError < Error; end
-  end
-end