resend 0.24.0 → 0.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 17fbcff646b3034847bea36e37e12f63a8654fd38cdc66da8fd935704d613250
-  data.tar.gz: 4a5105290aa022dd5e72ef6e546294dd23c50d7dc7fb1458c40c51ac679517d8
+  metadata.gz: 380fc77dd4f78646cea876d8a41c040c2456f5d83de51794adb366ae0cdf4c68
+  data.tar.gz: 6e868e3144a11781a20dcdd7fc2613e01885820d621595421845bceefee4c334
 SHA512:
-  metadata.gz: c469989bed973379461c1b93a837f7acd8f1a6cfceac4007f49cf9215189307faed7018cf7fd6adba389af9cfffacda93bc434aba1c739452f58a75f042b19b4
-  data.tar.gz: 590552f7916c9b870fbaed5f54ebbb35652aa3bf8a9b332c020d1e77345c2020ba61fa8f95fc6943f0d2e3ded9907f99a9c9507a3eb76b6a5721dd37fc97507a
+  metadata.gz: 6aecfeb42d92ef7a7c90620a0a529f522b26c00b9341cdcf2ca0ae71c100710703b4162b96d4889f29a09825285a923ce1feaef465765ce2d060dffcf17405d4
+  data.tar.gz: c14fb10e9a778579ad5c1615899db85b90e2feba28a7b6441f0b3dcde4679a1d4bafe26ef93e9631ca2087540ade271687b174d797acad10afda53eacef4f10b

data/README.md

@@ -72,7 +72,7 @@ puts r
 
 You can view all the examples in the [examples folder](https://github.com/drish/resend-ruby/tree/main/examples)
 
-# Rails and ActiveMailer support
+# Rails and ActionMailer support
 
 This gem can be used as an ActionMailer delivery method, add this to your `config/environments/environment.rb` file.
 

data/lib/resend/api_keys.rb

@@ -11,8 +11,8 @@ module Resend
       end
 
       # https://resend.com/docs/api-reference/api-keys/list-api-keys
-      def list
-        path = "api-keys"
+      def list(params = {})
+        path = Resend::PaginationHelper.build_paginated_path("api-keys", params)
         Resend::Request.new(path, {}, "get").perform
       end
 

data/lib/resend/audiences.rb

@@ -17,8 +17,8 @@ module Resend
       end
 
       # https://resend.com/docs/api-reference/audiences/list-audiences
-      def list
-        path = "audiences"
+      def list(params = {})
+        path = Resend::PaginationHelper.build_paginated_path("audiences", params)
         Resend::Request.new(path, {}, "get").perform
       end
 

data/lib/resend/batch.rb

@@ -4,6 +4,27 @@ module Resend
   # Module responsible for wrapping Batch email sending API
   module Batch
     class << self
+      # Send a batch of emails
+      #
+      # @param params [Array<Hash>] Array of email parameters (max 100 emails)
+      # @param options [Hash] Additional options for the request
+      # @option options [String] :idempotency_key Optional idempotency key
+      # @option options [String] :batch_validation Batch validation mode: "strict" (default) or "permissive"
+      #   - "strict": Entire batch fails if any email is invalid
+      #   - "permissive": Sends valid emails and returns errors for invalid ones
+      #
+      # @return [Hash] Response with :data array and optional :errors array (in permissive mode)
+      #
+      # @example Send batch with strict validation (default)
+      #   Resend::Batch.send([
+      #     { from: "sender@example.com", to: ["recipient@example.com"], subject: "Hello", html: "<p>Hi</p>" }
+      #   ])
+      #
+      # @example Send batch with permissive validation
+      #   response = Resend::Batch.send(emails, options: { batch_validation: "permissive" })
+      #   # response[:data] contains successful email IDs
+      #   # response[:errors] contains validation errors with index and message
+      #
       # https://resend.com/docs/api-reference/emails/send-batch-emails
       def send(params = [], options: {})
         path = "emails/batch"

data/lib/resend/broadcasts.rb

@@ -23,8 +23,8 @@ module Resend
       end
 
       # https://resend.com/docs/api-reference/broadcasts/list-broadcasts
-      def list
-        path = "broadcasts"
+      def list(params = {})
+        path = Resend::PaginationHelper.build_paginated_path("broadcasts", params)
         Resend::Request.new(path, {}, "get").perform
       end
 

data/lib/resend/contacts.rb

@@ -26,9 +26,10 @@ module Resend
       # List contacts in an audience
       #
       # @param audience_id [String] the audience id
+      # @param params [Hash] optional pagination parameters
       # https://resend.com/docs/api-reference/contacts/list-contacts
-      def list(audience_id)
-        path = "audiences/#{audience_id}/contacts"
+      def list(audience_id, params = {})
+        path = Resend::PaginationHelper.build_paginated_path("audiences/#{audience_id}/contacts", params)
         Resend::Request.new(path, {}, "get").perform
       end
 

data/lib/resend/domains.rb

@@ -22,9 +22,9 @@ module Resend
         Resend::Request.new(path, {}, "get").perform
       end
 
-      # https://resend.com/docs/api-reference/api-keys/list-api-keys
-      def list
-        path = "domains"
+      # https://resend.com/docs/api-reference/domains/list-domains
+      def list(params = {})
+        path = Resend::PaginationHelper.build_paginated_path("domains", params)
         Resend::Request.new(path, {}, "get").perform
       end
 

data/lib/resend/emails.rb

@@ -31,6 +31,25 @@ module Resend
         path = "emails/#{email_id}/cancel"
         Resend::Request.new(path, {}, "post").perform
       end
+
+      # List emails with optional pagination.
+      # see more: https://resend.com/docs/api-reference/emails/list-emails
+      #
+      # @param options [Hash] Optional parameters for pagination
+      # @option options [Integer] :limit Maximum number of emails to return (1-100, default 20)
+      # @option options [String] :after Cursor for pagination (newer emails)
+      # @option options [String] :before Cursor for pagination (older emails)
+      def list(options = {})
+        path = "emails"
+
+        # Build query parameters, filtering out nil values
+        query_params = {}
+        query_params[:limit] = options[:limit] if options[:limit]
+        query_params[:after] = options[:after] if options[:after]
+        query_params[:before] = options[:before] if options[:before]
+
+        Resend::Request.new(path, query_params, "get").perform
+      end
     end
 
     # This method is kept here for backwards compatibility

data/lib/resend/errors.rb

@@ -17,7 +17,17 @@ module Resend
     InvalidRequestError = Class.new(ServerError)
 
     # code 429
-    RateLimitExceededError = Class.new(ServerError)
+    class RateLimitExceededError < ServerError
+      attr_reader :rate_limit_limit, :rate_limit_remaining, :rate_limit_reset, :retry_after
+
+      def initialize(msg, code = nil, headers = {})
+        super(msg, code, headers)
+        @rate_limit_limit = headers["ratelimit-limit"]&.to_i
+        @rate_limit_remaining = headers["ratelimit-remaining"]&.to_i
+        @rate_limit_reset = headers["ratelimit-reset"]&.to_i
+        @retry_after = headers["retry-after"]&.to_i
+      end
+    end
 
     # code 404
     NotFoundError = Class.new(ServerError)
@@ -31,9 +41,12 @@ module Resend
       500 => Resend::Error::InternalServerError
     }.freeze
 
-    def initialize(msg, code = nil)
+    attr_reader :headers
+
+    def initialize(msg, code = nil, headers = {})
       super(msg)
       @code = code
+      @headers = headers
     end
   end
 end

data/lib/resend/pagination_helper.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Resend
+  # Helper class for building paginated query strings
+  class PaginationHelper
+    class << self
+      # Builds a paginated path with query parameters
+      #
+      # @param base_path [String] the base API path
+      # @param query_params [Hash] optional pagination parameters
+      # @option query_params [Integer] :limit Number of items to retrieve (max 100)
+      # @option query_params [String] :after ID after which to retrieve more items
+      # @option query_params [String] :before ID before which to retrieve more items
+      # @return [String] the path with query parameters
+      def build_paginated_path(base_path, query_params = nil)
+        return base_path if query_params.nil? || query_params.empty?
+
+        # Filter out nil values and convert to string keys
+        filtered_params = query_params.compact.transform_keys(&:to_s)
+
+        # Build query string
+        query_string = filtered_params.map { |k, v| "#{k}=#{CGI.escape(v.to_s)}" }.join("&")
+
+        return base_path if query_string.empty?
+
+        "#{base_path}?#{query_string}"
+      end
+    end
+  end
+end

data/lib/resend/request.rb

@@ -25,38 +25,56 @@ module Resend
       }
 
       set_idempotency_key
+      set_batch_validation
     end
 
     # Performs the HTTP call
     def perform
-      options = {
-        headers: @headers
-      }
-      options[:body] = @body.to_json unless @body.empty?
-
+      options = build_request_options
       resp = HTTParty.send(@verb.to_sym, "#{BASE_URL}#{@path}", options)
 
       check_json!(resp)
-
-      resp.transform_keys!(&:to_sym) unless resp.body.empty?
-      handle_error!(resp) if resp[:statusCode] && (resp[:statusCode] != 200 || resp[:statusCode] != 201)
-      resp
+      process_response(resp)
     end
 
     def handle_error!(resp)
       code = resp[:statusCode]
       body = resp[:message]
+      headers = resp.respond_to?(:headers) ? resp.headers : (resp[:headers] || {})
 
       # get error from the known list of errors
-      error = Resend::Error::ERRORS[code]
-      raise(error.new(body, code)) if error
-
-      # Raise generic Resend error when the error code is not part of the known errors
-      raise Resend::Error.new(body, code)
+      error_class = Resend::Error::ERRORS[code] || Resend::Error
+      raise error_class.new(body, code, headers)
     end
 
     private
 
+    def build_request_options
+      options = { headers: @headers }
+
+      if get_request_with_query?
+        options[:query] = @body
+      elsif !@body.empty?
+        options[:body] = @body.to_json
+      end
+
+      options
+    end
+
+    def get_request_with_query?
+      @verb.downcase == "get" && !@body.empty?
+    end
+
+    def process_response(resp)
+      resp.transform_keys!(&:to_sym) unless resp.body.empty?
+      handle_error!(resp) if error_response?(resp)
+      resp
+    end
+
+    def error_response?(resp)
+      resp[:statusCode] && (resp[:statusCode] != 200 && resp[:statusCode] != 201)
+    end
+
     def set_idempotency_key
       # Only set idempotency key if the verb is POST for now.
       #
@@ -66,6 +84,14 @@ module Resend
       end
     end
 
+    def set_batch_validation
+      # Set x-batch-validation header for batch emails
+      # Supported values: 'strict' (default) or 'permissive'
+      if @path == "emails/batch" && @options[:batch_validation]
+        @headers["x-batch-validation"] = @options[:batch_validation]
+      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.24.0"
+  VERSION = "0.26.0"
 end

data/lib/resend.rb

@@ -6,9 +6,11 @@ require "resend/version"
 # Utils
 require "httparty"
 require "json"
+require "cgi"
 require "resend/errors"
 require "resend/client"
 require "resend/request"
+require "resend/pagination_helper"
 
 # API Operations
 require "resend/audiences"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: resend
 version: !ruby/object:Gem::Version
-  version: 0.24.0
+  version: 0.26.0
 platform: ruby
 authors:
 - Derich Pacheco
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-13 00:00:00.000000000 Z
+date: 2025-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -56,6 +56,7 @@ files:
 - lib/resend/emails.rb
 - lib/resend/errors.rb
 - lib/resend/mailer.rb
+- lib/resend/pagination_helper.rb
 - lib/resend/railtie.rb
 - lib/resend/request.rb
 - lib/resend/version.rb