render25 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e3aa2a20fe0a39dbfe8decc4ee300dff6e1e35db6905e9aaad4dc54964b6a4bb
+  data.tar.gz: '082b5319a6c14b8ff592c4b865c236bdfc8f251987bb9bd53da493e06c6b9dfa'
+SHA512:
+  metadata.gz: 5c6d6d7138ce4675f8f85ac181918ce6a721d2e9815770a942a94d7fea9cae4fb1f6c6aaa9920e50c43fec072243beb62f6cc265754481413b8779c648a2954e
+  data.tar.gz: 063d367281300d42bfe2772d79b9a7668e38838c77f85811400efa45fe483affab4bcc8fc7b6ee3f6491df949ab92333a4b57a80a63efc1650db8b63b66b83d4

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Render25
+
+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,93 @@
+# Render25 Ruby SDK
+
+The official Ruby gem for the [Render25](https://render25.com) transactional email platform.
+
+[![Gem Version](https://badge.fury.io/rb/render25.svg)](https://badge.fury.io/rb/render25)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+## Installation
+
+Add this line to your application's `Gemfile`:
+
+```ruby
+gem 'render25'
+```
+
+And then execute:
+
+```bash
+bundle install
+```
+
+Or install it yourself as:
+
+```bash
+gem install render25
+```
+
+## Quickstart
+
+```ruby
+require 'render25'
+
+# Automatically loads RENDER25_API_KEY from environment
+client = Render25.new
+
+# Or pass explicitly: client = Render25.new('re_live_...')
+
+response = client.emails.send(
+  from: 'support@yourdomain.com',
+  to: 'user@example.com',
+  subject: 'Welcome to Render25!',
+  html: '<h1>Welcome aboard!</h1><p>Transactional email delivered via Ruby.</p>',
+  text: 'Welcome aboard! Transactional email delivered via Ruby.'
+)
+
+puts "Dispatched ID: #{response['id']}"
+```
+
+## Advanced: CC, BCC, Reply-To & Attachments
+
+```ruby
+require 'render25'
+
+client = Render25.new
+
+response = client.emails.send(
+  from: 'support@yourdomain.com',
+  to: ['client@example.com'],
+  cc: ['accounting@example.com'],
+  bcc: ['archive@example.com'],
+  reply_to: 'helpdesk@yourdomain.com',
+  subject: 'Your Invoice #1042',
+  html: '<p>Please find your receipt and invoice attached.</p>',
+  attachments: [
+    {
+      filename: 'invoice_1042.pdf',
+      content: File.binread('invoice.pdf'), # Pass binary string or file path
+      content_type: 'application/pdf'
+    }
+  ]
+)
+```
+
+## Ruby on Rails Integration
+
+In `config/environments/production.rb`:
+
+```ruby
+# Using ActionMailer with SMTP relay
+config.action_mailer.delivery_method = :smtp
+config.action_mailer.smtp_settings = {
+  address:              'smtp.render25.com',
+  port:                 587,
+  user_name:            ENV['RENDER25_USERNAME'],
+  password:             ENV['RENDER25_API_KEY'],
+  authentication:       :plain,
+  enable_starttls_auto: true
+}
+```
+
+## License
+
+MIT © [Render25](https://render25.com)

data/lib/render25.rb

@@ -0,0 +1,113 @@
+require 'net/http'
+require 'uri'
+require 'json'
+require 'base64'
+
+module Render25
+  class Error < StandardError; end
+
+  def self.new(api_key = nil, options = {})
+    Client.new(api_key, options)
+  end
+
+  class Client
+    attr_reader :api_key, :base_url, :emails
+
+    def initialize(api_key = nil, options = {})
+      @api_key = api_key || ENV['RENDER25_API_KEY']
+      raise ArgumentError, "Render25: API Key is required. Pass it to Render25.new(api_key) or set RENDER25_API_KEY environment variable." if @api_key.nil? || @api_key.empty?
+
+      @base_url = (options[:base_url] || ENV['RENDER25_BASE_URL'] || "https://api.render25.com").sub(/\/+$/, '')
+      @emails = EmailsService.new(self)
+    end
+  end
+
+  class EmailsService
+    def initialize(client)
+      @client = client
+    end
+
+    def send(options = {})
+      sender = options[:from] || options[:from_address]
+      raise ArgumentError, "Render25: :from address is required" unless sender
+
+      to = options[:to]
+      raise ArgumentError, "Render25: :to must contain at least one recipient" unless to
+      to = [to] if to.is_a?(String)
+
+      raise ArgumentError, "Render25: :subject is required" unless options[:subject]
+
+      payload = {
+        from: sender,
+        to: to,
+        subject: options[:subject],
+        text: options[:text] || '',
+        html: options[:html] || ''
+      }
+
+      if options[:cc]
+        payload[:cc] = options[:cc].is_a?(Array) ? options[:cc] : [options[:cc]]
+      end
+
+      if options[:bcc]
+        payload[:bcc] = options[:bcc].is_a?(Array) ? options[:bcc] : [options[:bcc]]
+      end
+
+      reply_to = options[:reply_to] || options[:replyTo]
+      payload[:reply_to] = reply_to if reply_to
+
+      if options[:attachments] && options[:attachments].is_a?(Array)
+        payload[:attachments] = options[:attachments].map do |att|
+          filename = att[:filename] || 'attachment.bin'
+          content = att[:content]
+          content_type = att[:content_type] || att[:contentType] || 'application/octet-stream'
+
+          b64_content = if content.is_a?(String) && File.exist?(content)
+                          Base64.strict_encode64(File.binread(content))
+                        elsif content.is_a?(String)
+                          # If already base64 or plain string
+                          begin
+                            Base64.strict_decode64(content)
+                            content
+                          rescue
+                            Base64.strict_encode64(content)
+                          end
+                        else
+                          Base64.strict_encode64(content.to_s)
+                        end
+
+          {
+            filename: filename,
+            content: b64_content,
+            content_type: content_type
+          }
+        end
+      end
+
+      uri = URI.parse("#{@client.base_url}/api/send")
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = (uri.scheme == 'https')
+      http.open_timeout = 10
+      http.read_timeout = 30
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request['Authorization'] = "Bearer #{@client.api_key}"
+      request['Content-Type'] = 'application/json'
+      request['User-Agent'] = 'render25-ruby/1.0.0'
+      request.body = payload.to_json
+
+      begin
+        response = http.request(request)
+        parsed = JSON.parse(response.body) rescue { "error" => response.body }
+
+        if response.code.to_i >= 200 && response.code.to_i < 300
+          parsed
+        else
+          raise Error, "Render25 Error (#{response.code}): #{parsed['error'] || 'Unknown REST API error'}"
+        end
+      rescue StandardError => e
+        raise Error, "Render25 Error: #{e.message}"
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,51 @@
+--- !ruby/object:Gem::Specification
+name: render25
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Render25 Team
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-08-11 00:00:00.000000000 Z
+dependencies: []
+description: Send high-deliverability transactional emails with Render25 using Ruby
+  and Ruby on Rails.
+email:
+- support@render25.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/render25.rb
+homepage: https://render25.com
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://render25.com
+  documentation_uri: https://render25.com/docs
+  source_code_uri: https://github.com/Render-25/ruby-sdk
+  bug_tracker_uri: https://github.com/Render-25/ruby-sdk/issues
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Official Ruby SDK for Render25 transactional email service
+test_files: []