resent 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c4f7acd5d5dae1962175ef7c965b555542a2b42049362b4a9164184e4a19ce13
+  data.tar.gz: '04980611b9520269bb6c46a40e74db9a279c06f5399d4d4e510e44019e407770'
+SHA512:
+  metadata.gz: 11e60f8e51296234a12940b19d2dbe1aed0bcc076fc4fbee5e9245542ffe7f8459897d7366e9a6e76147736854c13680e3a33b32d35fec47125fa826a6d5847e
+  data.tar.gz: 3a698ea03305e16b257e599af745a7ddd5d6bbbca956d56560949883f88723823cb3263d01de8b1408517687e8f6907f0e0bd6be8d2feefaa3427ead1758df75

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Resent
+
+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,82 @@
+<p align="center">
+  <img
+    alt="Send emails with Ruby — Resent"
+    src="https://raw.githubusercontent.com/resentmail/resent-ruby/main/assets/banner.jpg"
+    width="100%"
+  />
+</p>
+
+<p align="center">
+  <a href="https://developers.resent.one">Documentation</a>
+  ·
+  <a href="https://resent.one">Website</a>
+  ·
+  <a href="https://rubygems.org/gems/resent">RubyGems</a>
+  ·
+  <a href="https://github.com/resentmail/resent-ruby">GitHub</a>
+</p>
+
+# Resent Ruby SDK
+
+The official Ruby library for [Resent](https://resent.one) transactional email.
+
+## Install
+
+```bash
+gem install resent
+```
+
+Or in your Gemfile:
+
+```ruby
+gem "resent"
+```
+
+```bash
+bundle install
+```
+
+## Setup
+
+1. Verify a sending domain in the [Resent dashboard](https://resent.one/app/settings/domains/)
+2. Create an API key under [Settings → API keys](https://resent.one/app/settings/api-keys/)
+3. Store it as `RESENT_API_KEY`
+
+## Usage
+
+```ruby
+require "resent"
+
+resent = Resent.new(ENV.fetch("RESENT_API_KEY"))
+
+result = resent.emails.send(
+  from: "Acme <noreply@yourdomain.com>",
+  to: "you@example.com",
+  subject: "Hello World",
+  html: "<strong>It works!</strong>"
+)
+
+puts result["submission_id"]
+```
+
+## Send email using HTML
+
+```ruby
+result = resent.emails.send(
+  from: "Acme <noreply@yourdomain.com>",
+  to: ["you@example.com"],
+  subject: "Hello World",
+  html: "<strong>It works!</strong>"
+)
+```
+
+## Docs
+
+- [Getting started](https://developers.resent.one)
+- [Send transactional email](https://developers.resent.one/guides/send-transactional-email)
+- [Ruby SDK docs](https://developers.resent.one/sdks/ruby)
+- [API overview](https://developers.resent.one)
+
+## License
+
+MIT © [Resent](https://resent.one)

data/lib/resent/client.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+require "json"
+require "net/http"
+require "uri"
+
+module Resent
+  class Error < StandardError
+    attr_reader :status, :body
+
+    def initialize(message, status: nil, body: nil)
+      super(message)
+      @status = status
+      @body = body
+    end
+  end
+
+  # Official Resent API client.
+  #
+  #   resent = Resent::Client.new(ENV.fetch("RESENT_API_KEY"))
+  #   result = resent.emails.send(
+  #     from: "Acme <noreply@yourdomain.com>",
+  #     to: "you@example.com",
+  #     subject: "Hello",
+  #     html: "<strong>It works!</strong>"
+  #   )
+  class Client
+    DEFAULT_BASE_URL = "https://resent.one/api/v1"
+
+    attr_reader :api_key, :base_url
+
+    def initialize(api_key = nil, base_url: DEFAULT_BASE_URL)
+      key = (api_key || ENV["RESENT_API_KEY"]).to_s.strip
+      raise Error, "Missing API key. Pass Resent::Client.new(key) or set RESENT_API_KEY." if key.empty?
+
+      @api_key = key
+      @base_url = base_url.to_s.sub(%r{/+\z}, "")
+    end
+
+    def emails
+      Emails.new(self)
+    end
+
+    def request(method, path, body: nil)
+      uri = URI("#{@base_url}/#{path.sub(%r{\A/}, "")}")
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      http.open_timeout = 15
+      http.read_timeout = 30
+
+      request = case method.to_s.upcase
+                when "POST" then Net::HTTP::Post.new(uri)
+                when "GET" then Net::HTTP::Get.new(uri)
+                else
+                  raise Error, "Unsupported HTTP method: #{method}"
+                end
+
+      request["Authorization"] = "Bearer #{api_key}"
+      request["Accept"] = "application/json"
+      request["Content-Type"] = "application/json"
+      request["User-Agent"] = "resent-ruby/#{VERSION}"
+      request.body = JSON.generate(body) if body
+
+      response = http.request(request)
+      parsed = parse_json(response.body)
+
+      unless response.is_a?(Net::HTTPSuccess)
+        message = if parsed.is_a?(Hash) && parsed["error"]
+                    parsed["error"].to_s
+                  else
+                    "Resent API error (#{response.code})"
+                  end
+        raise Error.new(message, status: response.code.to_i, body: parsed)
+      end
+
+      parsed
+    end
+
+    private
+
+    def parse_json(raw)
+      return {} if raw.nil? || raw.strip.empty?
+
+      JSON.parse(raw)
+    rescue JSON::ParserError
+      { "raw" => raw }
+    end
+  end
+
+  class Emails
+    def initialize(client)
+      @client = client
+    end
+
+    # Send a transactional email.
+    #
+    # Required: from, to, subject, and html and/or text.
+    def send(from:, to:, subject:, html: nil, text: nil, cc: nil, bcc: nil, reply_to: nil)
+      to_list = Array(to).map { |v| v.to_s.strip }.reject(&:empty?)
+      raise Error, "from is required" if from.to_s.strip.empty?
+      raise Error, "to is required" if to_list.empty?
+      raise Error, "subject is required" if subject.to_s.strip.empty?
+      raise Error, "html or text body is required" if html.to_s.strip.empty? && text.to_s.strip.empty?
+
+      payload = {
+        "from" => from.to_s.strip,
+        "to" => to_list,
+        "subject" => subject.to_s
+      }
+      payload["html"] = html if html && !html.to_s.empty?
+      payload["text"] = text if text && !text.to_s.empty?
+      payload["cc"] = Array(cc) if cc
+      payload["bcc"] = Array(bcc) if bcc
+      payload["reply_to"] = reply_to if reply_to
+
+      @client.request("POST", "email/send", body: payload)
+    end
+  end
+end

data/lib/resent/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Resent
+  VERSION = "0.1.0"
+end

data/lib/resent.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require_relative "resent/version"
+require_relative "resent/client"
+
+# Convenience alias matching other SDKs:
+#   resent = Resent.new(ENV["RESENT_API_KEY"])
+module Resent
+  def self.new(api_key = nil, base_url: Client::DEFAULT_BASE_URL)
+    Client.new(api_key, base_url: base_url)
+  end
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification
+name: resent
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Resent
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-07-26 00:00:00.000000000 Z
+dependencies: []
+description: Send transactional email with the Resent API from Ruby. Verify a domain,
+  set RESENT_API_KEY, then call Resent::Client#emails.send.
+email:
+- hello@resent.one
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- assets/banner.jpg
+- lib/resent.rb
+- lib/resent/client.rb
+- lib/resent/version.rb
+homepage: https://resent.one
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://resent.one
+  source_code_uri: https://github.com/resentmail/resent-ruby
+  changelog_uri: https://github.com/resentmail/resent-ruby
+  documentation_uri: https://developers.resent.one/sdks/ruby
+  bug_tracker_uri: https://github.com/resentmail/resent-ruby/issues
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.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 Resent transactional email
+test_files: []