zoho_zeptomail-rails 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f0bf6e9ef49de599fe563889619cf25c9bf0238a880883f2f0f1450635b647a2
+  data.tar.gz: 848cadd5d0d147b211bb5f4911503417989997d1adc81cccbd753c75e4e3560d
+SHA512:
+  metadata.gz: 8d486ca9835a50d60e43e11a28a8f640774162a9db124f41ea661c4ce398449c02b679b1e7bf8c400bdd1057cde0e44d2d05f2470b327a07cd5b90ce35c983e7
+  data.tar.gz: e76f5b6ca2c44a789bdd136d2ecd685ef57befb2ea8918e05ef5eb58f2c32f9557cc8acd103554b7f9c07fc4f65509b87f66f8a722addd54d5d2586bb8ad5b2f

data/.standard.yml

@@ -0,0 +1,3 @@
+# For available configuration options, see:
+#   https://github.com/standardrb/standard
+ruby_version: 3.1

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-03-18
+
+- Initial release

data/LICENSE.txt

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025, Zoho Corporation Pvt. Ltd.
+All Rights Reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,50 @@
+# Zoho ZeptoMail Rails
+
+### Setup
+
+```bash
+gem install zoho_zeptomail-rails
+```
+
+You will have to initalize it in your Gem file with `require "zoho_zeptomail-rails"`.
+
+1. Use the adapter:
+```ruby
+  ActionMailer::Base.delivery_method = :zohozeptomail
+```
+2. `zoho_zeptomail-ruby` gem requires `ZOHO_ZEPTOMAIL_API_KEY_TOKEN` and `ZOHO_ZEPTOMAIL_HOSTED_REGION` environment variable,
+   so make sure it's set.
+
+## Email
+
+### Send an email
+```ruby
+class TestMailer < ActionMailer::Base
+  default from: 'michael@zylker.com'
+
+  def msg(from, to, subject)
+    mail(
+      from: from,
+      to: to,
+      subject: subject,
+      cc: 'rebeca@zylker.com'
+    ) do
+        |format|
+        format.text { render plain: 'hello' }
+        format.html { render html: '<div>This is a test email</div>'}
+        attachments['filename.pdf'] = File.read('test/mailers/Hello.pdf')
+        attachments['text_filename.txt'] = File.read('test/mailers/Hello.txt')
+        attachments['image_filename.png'] = File.read('test/mailers/test.png')
+    end
+  end
+end
+
+class MailerTest < Minitest::Test
+  def setup
+  end
+
+  def test_text_message
+    TestMailer.msg( 'jerry@zylker.com', 'hello').deliver!
+  end
+end
+```

data/Rakefile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "standard/rake"
+
+task default: :standard

data/lib/delivery_method.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+require 'railtie'
+require 'zohozeptomail_mailer'
+
+module ZohozeptomailRails
+  class Mailer
+    def initialize(config)
+      # No config yet
+    end
+
+    # Sends the email and returns result
+    def deliver(msg)
+      ms_msg = RailsMsgToMsMsg.msg_to_ms_msg(msg)
+      ms_msg.send
+    end
+
+    def settings
+        # Define the settings method or use a custom configuration object
+        @settings ||= { return_response: true }  # Example settings
+    end
+
+    def deliver!(msg)
+       result = deliver(msg)
+       # Ensure result is not nil
+       if result.nil? || result.status < 200 || result.status > 204
+           puts result
+       end
+       result
+    end
+    private
+  end
+end

data/lib/railtie.rb

@@ -0,0 +1,11 @@
+require 'rails/railtie'
+require 'delivery_method'
+require 'zoho_zeptomail-ruby'
+
+module ZohozeptomailRails
+  class Railtie < ::Rails::Railtie
+    ActiveSupport.on_load(:action_mailer) do
+      add_delivery_method :zohozeptomail, ZohozeptomailRails::Mailer
+    end
+  end
+end

data/lib/zoho_zeptomail/rails/master/version.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module ZohoZeptomail
+  module Rails
+    module Master
+      VERSION = "0.1.0"
+    end
+  end
+end

data/lib/zoho_zeptomail/rails/master.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require_relative "master/version"
+
+module ZohoZeptomail
+  module Rails
+    module Master
+      class Error < StandardError; end
+      # Your code goes here...
+    end
+  end
+end

data/lib/zoho_zeptomail/rails/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module ZohoZeptomail
+  module Rails
+    VERSION = "0.1.0"
+  end
+end

data/lib/zoho_zeptomail/rails.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative "rails/version"
+
+module ZohoZeptomail
+  module Rails
+    class Error < StandardError; end
+    # Your code goes here...
+  end
+end

data/lib/zoho_zeptomail-rails.rb

@@ -0,0 +1,3 @@
+require 'zohozeptomail_mailer'
+require 'delivery_method'
+require 'railtie'

data/lib/zohozeptomail_mailer.rb

@@ -0,0 +1,157 @@
+require 'cgi'
+
+module ZohozeptomailRails
+  class RailsMsgToMsMsg
+    def self.msg_to_ms_msg(msg)
+      ms_msg = ZohoZeptoMail::SendMail.new
+
+      if msg.from_addrs.empty?
+        raise 'From address should not be empty or nil'
+      else
+        ms_msg.add_from(rails_from_addr(msg.from_addrs))
+      end
+
+      if msg.subject.empty?
+        raise 'Subject should not be empty or nil'
+      else
+        ms_msg.add_subject(msg.subject)
+      end
+
+      if msg.to_addrs.empty?
+        raise 'Recipients address should not be empty or nil'
+      else
+        msg.to_addrs.each do |i|
+          ms_msg.add_recipients(rails_addr(i))
+        end
+      end
+
+      body_text = msg_text(msg) || ""
+      body_html = CGI.unescapeHTML(msg_html(msg))
+      if body_text != ""
+          body_text += '<br>' + body_html
+      else
+          body_text += body_html
+      end
+      ms_msg.add_body(body_text)
+
+      if msg.reply_to
+        msg.reply_to.each do |i|
+          ms_msg.add_reply_to(rails_addr(i))
+        end
+      end
+
+      rails_attach(msg.attachments, ms_msg)
+
+      if msg.cc_addrs
+        msg.cc_addrs.each do |i|
+          ms_msg.add_cc(rails_addr(i))
+        end
+      end
+
+      if msg.bcc_addrs
+        msg.bcc_addrs.each do |i|
+          ms_msg.add_bcc(rails_addr(i))
+        end
+      end
+
+      ms_msg
+    end
+
+    private
+
+    def self.rails_attach(attach, ms_msg)
+        if !attach.nil?
+            attach.each do |attachments|
+                ms_msg.add_attachments(content: attachments.body.decoded.to_s, filename: attachments.filename, mime_type: attachments.content_type)
+            end
+        end
+    end
+
+    def self.rails_addr(addr)
+        if addr.is_a?(Mail::Address)
+            name = addr.name || addr.address
+            email = addr.address
+        else
+            name = nil
+            email = addr
+        end
+        if name.nil?
+            {address: email}
+        else
+            { name: name, address: email }
+        end
+    end
+
+    def self.rails_from_addr(from_addrs)
+        if from_addrs.is_a?(Mail::Address)
+            name = from_addrs.name || from_addrs.address
+            email = from_addrs.address
+        else
+            name = nil
+            email = from_addrs
+        end
+        if name.nil?
+            { address: email[0] }
+        else
+            { name: name, address: email[0] }
+        end
+    end
+
+    def self.msg_text(msg)
+      text_parts = []
+      if msg.multipart?
+        msg.parts.each do |part|
+          if part.content_type =~ /^multipart\/alternative/i
+            text_parts.concat(extract_text_from_multipart_alternative(part))
+          end
+        end
+      end
+
+      if msg.mime_type =~ /^text\/plain$/i
+        text_parts << msg.body.decoded.to_s.strip
+      end
+      text_parts.join("<br>") unless text_parts.empty?
+    rescue => e
+      Rails.logger.error("Error extracting text from email: #{e.message}") if defined?(Rails)
+      raise
+    end
+
+    def self.extract_text_from_multipart_alternative(part)
+      nested_text_parts = []
+      part.parts.each do |sub_part|
+        if sub_part.content_type =~ /^text\/plain[;$]/i
+          nested_text_parts << sub_part.body.decoded.to_s.strip
+        end
+      end
+      nested_text_parts
+    end
+
+    def self.msg_html(msg)
+        html_parts = []
+        if msg.multipart?
+            msg.parts.each do |part|
+              if part.content_type =~ /^multipart\/alternative/i
+                html_parts.concat(extract_text_html_multipart_alternative(part))
+              elsif part.content_type =~ /^text\/html[;$]/i
+                html_parts << part.body.decoded.to_s.strip
+              end
+            end
+          end
+          if msg.mime_type =~ /^text\/html$/i
+            html_parts << msg.body.decoded.to_s.strip
+          end
+          clean_html = html_parts.join("<br>").gsub(/<\/?[^>]*>/, '').strip
+          clean_html
+      end
+
+    def self.extract_text_html_multipart_alternative(part)
+        nested_text_parts = []
+        part.parts.each do |sub_part|
+            if sub_part.content_type =~ /^text\/html[;$]/i
+               nested_text_parts << sub_part.body.decoded.to_s.strip
+            end
+        end
+        nested_text_parts
+    end
+  end
+end

data/sig/zoho_zeptomail/rails/master.rbs

@@ -0,0 +1,8 @@
+module ZohoZeptomail
+  module Rails
+    module Master
+      VERSION: String
+      # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+    end
+  end
+end

data/sig/zoho_zeptomail/rails.rbs

@@ -0,0 +1,6 @@
+module ZohoZeptomail
+  module Rails
+    VERSION: String
+    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+  end
+end

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: zoho_zeptomail-rails
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- ZohoMail
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-03-18 00:00:00.000000000 Z
+dependencies: []
+description:
+email:
+- zmintegration@zohomail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".DS_Store"
+- ".standard.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/.DS_Store
+- lib/delivery_method.rb
+- lib/railtie.rb
+- lib/zoho_zeptomail-rails.rb
+- lib/zoho_zeptomail/.DS_Store
+- lib/zoho_zeptomail/rails.rb
+- lib/zoho_zeptomail/rails/.DS_Store
+- lib/zoho_zeptomail/rails/master.rb
+- lib/zoho_zeptomail/rails/master/version.rb
+- lib/zoho_zeptomail/rails/version.rb
+- lib/zohozeptomail_mailer.rb
+- sig/.DS_Store
+- sig/zoho_zeptomail/.DS_Store
+- sig/zoho_zeptomail/rails.rbs
+- sig/zoho_zeptomail/rails/master.rbs
+homepage: https://www.zoho.com/zeptomail/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://www.zoho.com/zeptomail/
+  source_code_uri: https://github.com/zohomail/zoho_zeptomail-rails/
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.3
+signing_key:
+specification_version: 4
+summary: Zoho ZeptoMail official Ruby SDK
+test_files: []