mailtrap 1.2.1 → 1.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7dee4a202b02e16f840e8fc74526903e10418a0073c2392faf964dcdbcdfcde4
-  data.tar.gz: d35cf9fa125e8ec587f96626be7830f4398002173b7dc07c4560dddbbb0ddb3e
+  metadata.gz: c02915dc1ea123fb592af56b9c553cb97e6137f0555b98f965f3a8cf1dd1d229
+  data.tar.gz: 8e7da7be2313f3e3766512e5c4014f90d1f8f1ddb271cbd255494252b6eda161
 SHA512:
-  metadata.gz: 5b4c0ba57ab2cab64cec15704bd34c04be134360a2600d2fc530bcae47ab8caf2e8dd79ce7ba5fd342e46dad599153d473006613c953da868182dcff2bb1e2be
-  data.tar.gz: 45d64a548b0cd54e0f98394a8c6739d1bc5dcd90716105100f7bae92f7aa5913c9ff66fde412d8965d3818bc7d6594c1c218d96cfcde59eabc6bd92c1901e2c3
+  metadata.gz: 962e1a2227a79b264bd637f643ffbf326c03d56ba1736a406869fda693eb67c5ffed3797cacd1862403e034ba543c44094829fe45ec36c6fcfa2e96ecdd554c3
+  data.tar.gz: b568ff9976cba7311ae02118bbbe5b825230743facd0094921fa3ac58d4fe4d8132c9b9bbc5dca4c6d60fc798fa18d8508149a871949de971e621af50c386177

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## [1.2.2] - 2023-11-01
+
+- Improved error handling
+
 ## [1.2.1] - 2023-04-12
 
 - Set custom user agent

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    mailtrap (1.2.1)
+    mailtrap (1.2.2)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -130,6 +130,20 @@ mail(
 )
 ```
 
+#### 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 
+sending. For example, `/api/send` endpoint ignores `Content-Transfer-Encoding`
+(see `headers` in the [API documentation](https://railsware.stoplight.io/docs/mailtrap-api-docs/67f1d70aeb62c-send-email)).
+Meaning your recipients will receive emails only in the default encoding which 
+is `quoted-printable`, if you send with Mailtrap API.
+
+For those who does need to use `7bit` or any other encoding, SMTP provides 
+better flexibility in that regard. Go to your _Mailtrap account_ → _Email Sending_ 
+→ _Sending Domains_ → _Your domain_ → _SMTP/API Settings_ to find the SMTP 
+configuration example.
+
 ## 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/sending/client.rb

@@ -43,16 +43,26 @@ module Mailtrap
         request
       end
 
-      def handle_response(response)
-        case response.code
-        when '200'
+      def handle_response(response) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
+        case response
+        when Net::HTTPOK
           json_response(response.body)
-        when '400'
+        when Net::HTTPBadRequest
           raise Mailtrap::Sending::Error, json_response(response.body)[:errors]
-        when '401'
+        when Net::HTTPUnauthorized
           raise Mailtrap::Sending::AuthorizationError, json_response(response.body)[:errors]
-        else
+        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
 

data/lib/mailtrap/sending.rb

@@ -17,6 +17,21 @@ module Mailtrap
       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

data/lib/mailtrap/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mailtrap
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.2.2
 platform: ruby
 authors:
 - Railsware Products Studio LLC
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-04-13 00:00:00.000000000 Z
+date: 2023-11-09 00:00:00.000000000 Z
 dependencies: []
 description: Official mailtrap.io API client
 email: