sidemail-delivery 0.1.2 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6bac5ee4f015725a6442178f1e67e7b9b2ecb335bd731d9b426af39c9ee76968
-  data.tar.gz: 05a87d3b2fe317d9fbb598ab07ef37c23a813c541b96d40518e4ec2ec3cdb8a1
+  metadata.gz: e822a3942340d3d666202a702ba36cbeeb393462d7a4956b5591032821b36ea8
+  data.tar.gz: 992694a05e74f6fc5808bd1e8a542ce6664aa4aeab9ec8e2dabaefc661627540
 SHA512:
-  metadata.gz: df1abd94dd8ac857b49694d1443cb66de75629f787d1a74a218fed1ee945d21e519e7515c4bb2246f409a4b8c296c3215b4c4fac0a5948367c64f841bf8d7c20
-  data.tar.gz: a725dc1dac4e9aef432b1ae21b0c282f1b7cf22e808088f696b906bad4b18cb0f99edfb9250c24fecdc5aa41528ea505b4f049f81917970dc5b69e8aaa2d9db1
+  metadata.gz: 24904cd8867f4182d50db9fabaefd80f6d3de74edebe82e5a42b7b8f1cf8c36bce64bf11e0c2e421366d66203172be5af1414019377d497a6f29cd14a5eb8171
+  data.tar.gz: 3929ba4a6eb3bba0986e9e8b2eb829b8d6c90e0e01577ffab5e2bada94a7f6b10cc5c9a2da497a1f6675e26fe8a678935b7116eb5c7b5618c4310289f3d4e45c

data/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+### Added
+### Fixed
+### Changed
+### Removed
+
+## [0.2.1] - 2024-02-08
+### Fixed
+- Nested structures in template properties.
+
+## [0.2.0] - 2024-02-08
+### Added
+- Support for Sidemail templates and template properties.
+
+## [0.1.2] - 2024-02-07
+### Added
+- Extended the information displayed by `Sidemail::Delivery::Exception`.
+
+## [0.1.1] - 2024-02-01
+### Fixed
+- Homepage URL in gemspec.
+
+## [0.1.0] - 2024-02-01
+### Added
+- Deliver ActionMailer mails through Sidemail API. 

data/README.md

@@ -31,8 +31,18 @@ Rails.application.configure do
 end
 ```
 
-Finally you might need to contact Sidemail support to enable HTML sending through their API. 
+## Usage
+
+After the installation your existing mailers will automatically send their html/text views through Sidemail. You might
+need to contact Sidemail support to enable HTML sending through their API. 
 They disable it by default to prevent abuse.
 
+If you want to use templates you can modify your mailers to include the template name and properties in the mail call 
+and pass an empty body to avoid the need for having a mailer view. For example:
+
+```ruby
+mail(to: "somebody@example.com", template: "my-template-name", template_props: { name: "Somebody" }, body: "")
+```
+
 ## License
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/sidemail/delivery/exception.rb

@@ -0,0 +1,6 @@
+module Sidemail
+  module Delivery
+    class Exception < StandardError
+    end
+  end
+end

data/lib/sidemail/delivery/method.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Sidemail
+  module Delivery
+    class Method
+      URL = URI("https://api.sidemail.io/v1/email/send")
+
+      def initialize(_options)
+        # empty but unused, to avoid errors
+      end
+
+      def deliver!(mail)
+        response = post_to_api(mail[:to].addrs.map(&:address), payload(mail))
+        JSON.parse(response.body).tap do |json|
+          break unless json.key?("errorCode")
+
+          raise Sidemail::Delivery::Exception.new("#{json["errorCode"]}: #{json["developerMessage"]}")
+        end
+      rescue JSON::ParserError
+        raise Sidemail::Delivery::Exception.new("Unable to parse response")
+      end
+
+      protected
+
+      def payload(mail)
+        result = {
+          fromName: mail[:from].addrs.first.display_name,
+          fromAddress: mail[:from].addrs.first.address
+        }
+        result[:subject] = mail[:subject] if mail[:subject].present?
+        if mail[:template].present?
+          result[:templateName] = mail[:template]
+          result[:templateProps] = mail[:template_props].unparsed_value
+        else
+          result[:html] = mail.html_part.decoded
+          result[:text] = mail.text_part.decoded
+        end
+        if mail.attachments.size.positive?
+          result[:attachments] = mail.attachments.map do |attachment|
+            {name: attachment.filename, content: Base64.strict_encode64(attachment.body.decoded)}
+          end
+        end
+        result
+      end
+
+      def post_to_api(addresses, payload)
+        https = Net::HTTP.new(URL.host, URL.port)
+        https.use_ssl = true
+
+        request = Net::HTTP::Post.new(URL)
+        request["Content-Type"] = "application/json"
+        request["Authorization"] = "Bearer #{Sidemail::Delivery.settings.api_key}"
+        request.body = JSON.generate(addresses.map { |to| {toAddress: to}.merge(payload) })
+
+        https.request(request)
+      end
+    end
+  end
+end

data/lib/sidemail/delivery/settings.rb

@@ -0,0 +1,7 @@
+module Sidemail
+  module Delivery
+    class Settings
+      attr_accessor :api_key
+    end
+  end
+end

data/lib/sidemail/delivery/version.rb

@@ -1,5 +1,5 @@
 module Sidemail
   module Delivery
-    VERSION = "0.1.2"
+    VERSION = "0.2.1"
   end
 end

data/lib/sidemail/delivery.rb

@@ -1,5 +1,8 @@
-require "sidemail/delivery/version"
+require "sidemail/delivery/exception"
+require "sidemail/delivery/method"
 require "sidemail/delivery/railtie"
+require "sidemail/delivery/settings"
+require "sidemail/delivery/version"
 
 module Sidemail
   module Delivery
@@ -11,59 +14,5 @@ module Sidemail
       self.settings ||= Settings.new
       yield(settings)
     end
-
-    class Settings
-      attr_accessor :api_key
-    end
-
-    class Exception < StandardError
-    end
-
-    class Method
-      URL = URI("https://api.sidemail.io/v1/email/send")
-
-      def initialize(_options)
-        # empty but unused, to avoid errors
-      end
-
-      def deliver!(mail)
-        payload = {
-          fromName: mail[:from].addrs.first.display_name,
-          fromAddress: mail[:from].addrs.first.address,
-          html: mail.html_part.decoded,
-          text: mail.text_part.decoded,
-          subject: mail[:subject]
-        }
-        if mail.attachments.size.positive?
-          payload[:attachments] = mail.attachments.map do |attachment|
-            {name: attachment.filename, content: Base64.strict_encode64(attachment.body.decoded)}
-          end
-        end
-
-        response = post_to_api(mail[:to].addrs.map(&:address), payload)
-
-        JSON.parse(response.body).tap do |json|
-          break unless json.key?("errorCode")
-
-          raise Sidemail::Delivery::Exception.new("#{json["errorCode"]}: #{json["developerMessage"]}")
-        end
-      rescue JSON::ParserError
-        raise Sidemail::Delivery::Exception.new("Unable to parse response")
-      end
-
-      protected
-
-      def post_to_api(addresses, payload)
-        https = Net::HTTP.new(URL.host, URL.port)
-        https.use_ssl = true
-
-        request = Net::HTTP::Post.new(URL)
-        request["Content-Type"] = "application/json"
-        request["Authorization"] = "Bearer #{Sidemail::Delivery.settings.api_key}"
-        request.body = JSON.generate(addresses.map { |to| {toAddress: to}.merge(payload) })
-
-        https.request(request)
-      end
-    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sidemail-delivery
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.1
 platform: ruby
 authors:
 - Frank Groeneveld
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-02-07 00:00:00.000000000 Z
+date: 2024-09-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -37,7 +37,10 @@ files:
 - README.md
 - Rakefile
 - lib/sidemail/delivery.rb
+- lib/sidemail/delivery/exception.rb
+- lib/sidemail/delivery/method.rb
 - lib/sidemail/delivery/railtie.rb
+- lib/sidemail/delivery/settings.rb
 - lib/sidemail/delivery/version.rb
 homepage: https://github.com/toolsfactory-nl/sidemail-delivery
 licenses:
@@ -61,7 +64,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.5.11
 signing_key:
 specification_version: 4
 summary: Rails delivery method for Sidemail.