resend 0.25.0 → 0.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 58501f77e4e315fec8185ee1a1b74942d0daa553ba4d13275e8efb0729780225
-  data.tar.gz: ee0215aa0aa03241b817625736e26e99ff9c6194e19ff304b1cd0f12824bcd50
+  metadata.gz: 380fc77dd4f78646cea876d8a41c040c2456f5d83de51794adb366ae0cdf4c68
+  data.tar.gz: 6e868e3144a11781a20dcdd7fc2613e01885820d621595421845bceefee4c334
 SHA512:
-  metadata.gz: f37730c78b2579ac2bf6b739504a20d6e6472430c4614a9ec22cedb134d5f19f440106f2f2c9d615eff4198e8be19292d10953a8af1e463a1465dc2051f68d76
-  data.tar.gz: 68e4d7b0dc34700c1ddfee321f466f5a5f49319049cc2d54cb53a69063478941afab35907f9c66085caf56b96247bdf8da461117d677bdcae2898c8335cd019e
+  metadata.gz: 6aecfeb42d92ef7a7c90620a0a529f522b26c00b9341cdcf2ca0ae71c100710703b4162b96d4889f29a09825285a923ce1feaef465765ce2d060dffcf17405d4
+  data.tar.gz: c14fb10e9a778579ad5c1615899db85b90e2feba28a7b6441f0b3dcde4679a1d4bafe26ef93e9631ca2087540ade271687b174d797acad10afda53eacef4f10b

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/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

@@ -30,34 +30,51 @@ module Resend
 
     # 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.
       #

data/lib/resend/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Resend
-  VERSION = "0.25.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.25.0
+  version: 0.26.0
 platform: ruby
 authors:
 - Derich Pacheco
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-20 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