resend 0.19.0 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5bb6be8da121d99eb4df45bd57b2c241bcd79e73d13834e50a3d8d57d2f51bd2
-  data.tar.gz: 0fb9c8c8308921308997bc879e1634d811045b4d0dbdd166132c7860640c5c98
+  metadata.gz: a211cd93c4479cba4bf63b849bf8e91de3413e9ccf9917c681454fcd7ed832e0
+  data.tar.gz: 4e9ba38c842d04fbe3eb7d5987784b54d327ee9b1eaeec8dbfbcebf08110b948
 SHA512:
-  metadata.gz: e69c22d3ebf16c1c9b5502b9ab96a3a0669822177bed797de0c759809f5629e8e39fff36c4ecb7f9b3051147c835491fbe28c758472c52b3533161b802a3d8a7
-  data.tar.gz: 15922ee8535078e181257cb2a8ccb5c04912b13ba6af36f7e75670c1dc8e3dd820453349d3969d163cf39af53a004096dbd0b8515ef0767de5893be07f2bb8ae
+  metadata.gz: 63c27d58c685bd8edd04ce28817bbca66ed468113067c0f43f6b51bdf3add9ebcfeeb1d434bf2150f84d5ae4c7661860f834d7dfe62f7c5146bb75051408ae77
+  data.tar.gz: 5c63d4c381f0c53dc04b1c8b933b131e9d0bdf7aaf2a4354a9d1c454d75a2116a35fec481865e8668719d0e1fab875688acb6fa2968f3c09a116aeaf1e6500f3

data/lib/resend/contacts.rb

@@ -10,6 +10,12 @@ module Resend
         Resend::Request.new(path, params, "post").perform
       end
 
+      #
+      # Retrieves a contact from an audience
+      #
+      # @param audience_id [String] the audience id
+      # @param id [String] either the contact id or contact's email
+      #
       # https://resend.com/docs/api-reference/contacts/get-contact
       def get(audience_id, id)
         path = "audiences/#{audience_id}/contacts/#{id}"

data/lib/resend/emails.rb

@@ -5,10 +5,10 @@ module Resend
   module Emails
     class << self
       # Sends or schedules an email.
-      # see more: https://resend.com/docs/api-reference/send-email
-      def send(params)
+      # see more: https://resend.com/docs/api-reference/emails/send-email
+      def send(params, options: {})
         path = "emails"
-        Resend::Request.new(path, params, "post").perform
+        Resend::Request.new(path, params, "post", options: options).perform
       end
 
       # Retrieve a single email.

data/lib/resend/mailer.rb

@@ -15,9 +15,11 @@ module Resend
       from reply-to to subject mime-version
       html text
       content-type tags scheduled_at
-      headers
+      headers options
     ].freeze
 
+    SUPPORTED_OPTIONS = %w[idempotency_key].freeze
+
     def initialize(config)
       @config = config
       raise Resend::Error.new("Make sure your API Key is set", @config) unless Resend.api_key
@@ -35,7 +37,8 @@ module Resend
     #
     def deliver!(mail)
       params = build_resend_params(mail)
-      resp = Resend::Emails.send(params)
+      options = get_options(mail) if mail[:options].present?
+      resp = Resend::Emails.send(params, options: options || {})
       mail.message_id = resp[:id] if resp[:error].nil?
       resp
     end
@@ -92,6 +95,22 @@ module Resend
       params
     end
 
+    #
+    # Adds additional options fields.
+    # Currently supports only :idempotency_key
+    #
+    # @param Mail mail Rails Mail object
+    # @return Hash hash with headers param
+    #
+    def get_options(mail)
+      opts = {}
+      if mail[:options].present?
+        opts.merge!(mail[:options].unparsed_value)
+        opts.delete_if { |k, _v| !SUPPORTED_OPTIONS.include?(k.to_s) }
+      end
+      opts
+    end
+
     # Remove nils from header values
     def cleanup_headers(headers)
       headers.delete_if { |_k, v| v.nil? }

data/lib/resend/request.rb

@@ -6,9 +6,9 @@ module Resend
   class Request
     BASE_URL = ENV["RESEND_BASE_URL"] || "https://api.resend.com/"
 
-    attr_accessor :body, :verb
+    attr_accessor :body, :verb, :options
 
-    def initialize(path = "", body = {}, verb = "POST")
+    def initialize(path = "", body = {}, verb = "POST", options: {})
       raise if (api_key = Resend.api_key).nil?
 
       api_key = api_key.call if api_key.is_a?(Proc)
@@ -16,12 +16,15 @@ module Resend
       @path = path
       @body = body
       @verb = verb
+      @options = options
       @headers = {
         "Content-Type" => "application/json",
         "Accept" => "application/json",
         "User-Agent" => "resend-ruby:#{Resend::VERSION}",
         "Authorization" => "Bearer #{api_key}"
       }
+
+      set_idempotency_key
     end
 
     # Performs the HTTP call
@@ -29,7 +32,6 @@ module Resend
       options = {
         headers: @headers
       }
-
       options[:body] = @body.to_json unless @body.empty?
 
       resp = HTTParty.send(@verb.to_sym, "#{BASE_URL}#{@path}", options)
@@ -55,6 +57,15 @@ module Resend
 
     private
 
+    def set_idempotency_key
+      # Only set idempotency key if the verb is POST for now.
+      #
+      # Does not set it if the idempotency_key is nil or empty
+      if @verb.downcase == "post" && (!@options[:idempotency_key].nil? && !@options[:idempotency_key].empty?)
+        @headers["Idempotency-Key"] = @options[:idempotency_key]
+      end
+    end
+
     def check_json!(resp)
       if resp.body.is_a?(Hash)
         JSON.parse(resp.body.to_json)

data/lib/resend/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Resend
-  VERSION = "0.19.0"
+  VERSION = "0.21.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: resend
 version: !ruby/object:Gem::Version
-  version: 0.19.0
+  version: 0.21.0
 platform: ruby
 authors:
 - Derich Pacheco
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-25 00:00:00.000000000 Z
+date: 2025-05-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty