resend 0.25.0 → 0.27.0.alpha.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 58501f77e4e315fec8185ee1a1b74942d0daa553ba4d13275e8efb0729780225
-  data.tar.gz: ee0215aa0aa03241b817625736e26e99ff9c6194e19ff304b1cd0f12824bcd50
+  metadata.gz: c2285e905778c2a5332f4adc94ac29f229ed02b62645c4e074febd95202d56cc
+  data.tar.gz: 978ae7cf38ac0906c40d8af4b55aa5f0602a929bed2bc543b29500b157a94eaf
 SHA512:
-  metadata.gz: f37730c78b2579ac2bf6b739504a20d6e6472430c4614a9ec22cedb134d5f19f440106f2f2c9d615eff4198e8be19292d10953a8af1e463a1465dc2051f68d76
-  data.tar.gz: 68e4d7b0dc34700c1ddfee321f466f5a5f49319049cc2d54cb53a69063478941afab35907f9c66085caf56b96247bdf8da461117d677bdcae2898c8335cd019e
+  metadata.gz: 6c338e6d9b06847278ba7cd9bbd146f3d0d8012d5c614418a6ef9066c931cb73b4a270a407e74dfba7e6a5a27944c1996537c720d7108d6a838f5003a2aa2b7f
+  data.tar.gz: 396fdd53a1e21840dcbd996735a8570ec7e5353a87b4ce86ccb311f9dfcdd2cfa0928a0883b0727423ed39d8f5bf30a6b7afa45e60743191fd29ca593307f3e9

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/attachments/receiving.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module Resend
+  module Attachments
+    # Module for receiving email attachments API operations
+    module Receiving
+      class << self
+        # Retrieve a single attachment from a received email
+        #
+        # @param params [Hash] Parameters for retrieving the attachment
+        # @option params [String] :id The attachment ID (required)
+        # @option params [String] :email_id The email ID (required)
+        # @return [Hash] The attachment object
+        #
+        # @example
+        #   Resend::Attachments::Receiving.get(
+        #     id: "2a0c9ce0-3112-4728-976e-47ddcd16a318",
+        #     email_id: "4ef9a417-02e9-4d39-ad75-9611e0fcc33c"
+        #   )
+        def get(params = {})
+          attachment_id = params[:id]
+          email_id = params[:email_id]
+
+          path = "emails/receiving/#{email_id}/attachments/#{attachment_id}"
+          Resend::Request.new(path, {}, "get").perform
+        end
+
+        # List attachments from a received email with optional pagination
+        #
+        # @param params [Hash] Parameters for listing attachments
+        # @option params [String] :email_id The email ID (required)
+        # @option params [Integer] :limit Maximum number of attachments to return (1-100)
+        # @option params [String] :after Cursor for pagination (newer attachments)
+        # @option params [String] :before Cursor for pagination (older attachments)
+        # @return [Hash] List of attachments with pagination info
+        #
+        # @example List all attachments
+        #   Resend::Attachments::Receiving.list(
+        #     email_id: "4ef9a417-02e9-4d39-ad75-9611e0fcc33c"
+        #   )
+        #
+        # @example List with custom limit
+        #   Resend::Attachments::Receiving.list(
+        #     email_id: "4ef9a417-02e9-4d39-ad75-9611e0fcc33c",
+        #     limit: 50
+        #   )
+        #
+        # @example List with pagination
+        #   Resend::Attachments::Receiving.list(
+        #     email_id: "4ef9a417-02e9-4d39-ad75-9611e0fcc33c",
+        #     limit: 20,
+        #     after: "attachment_id_123"
+        #   )
+        def list(params = {})
+          email_id = params[:email_id]
+          path = "emails/receiving/#{email_id}/attachments"
+
+          # Build query parameters, filtering out nil values
+          query_params = {}
+          query_params[:limit] = params[:limit] if params[:limit]
+          query_params[:after] = params[:after] if params[:after]
+          query_params[:before] = params[:before] if params[:before]
+
+          Resend::Request.new(path, query_params, "get").perform
+        end
+      end
+    end
+  end
+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/receiving.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Resend
+  module Emails
+    # Module for receiving emails API operations
+    module Receiving
+      class << self
+        # Retrieve a single received email
+        #
+        # @param email_id [String] The ID of the received email
+        # @return [Hash] The received email object
+        #
+        # @example
+        #   Resend::Emails::Receiving.get("4ef9a417-02e9-4d39-ad75-9611e0fcc33c")
+        def get(email_id = "")
+          path = "emails/receiving/#{email_id}"
+          Resend::Request.new(path, {}, "get").perform
+        end
+
+        # List received emails with optional pagination
+        #
+        # @param params [Hash] Optional parameters for pagination
+        # @option params [Integer] :limit Maximum number of emails to return (1-100)
+        # @option params [String] :after Cursor for pagination (newer emails)
+        # @option params [String] :before Cursor for pagination (older emails)
+        # @return [Hash] List of received emails with pagination info
+        #
+        # @example List all received emails
+        #   Resend::Emails::Receiving.list
+        #
+        # @example List with custom limit
+        #   Resend::Emails::Receiving.list(limit: 50)
+        #
+        # @example List with pagination
+        #   Resend::Emails::Receiving.list(limit: 20, after: "email_id_123")
+        def list(params = {})
+          path = Resend::PaginationHelper.build_paginated_path("emails/receiving", params)
+          Resend::Request.new(path, {}, "get").perform
+        end
+      end
+    end
+  end
+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/topics.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Resend
+  # Topics api wrapper
+  module Topics
+    class << self
+      # https://resend.com/docs/api-reference/topics/create-topic
+      def create(params = {})
+        path = "topics"
+        Resend::Request.new(path, params, "post").perform
+      end
+
+      # https://resend.com/docs/api-reference/topics/get-topic
+      def get(topic_id = "")
+        path = "topics/#{topic_id}"
+        Resend::Request.new(path, {}, "get").perform
+      end
+
+      # https://resend.com/docs/api-reference/topics/update-topic
+      def update(params = {})
+        path = "topics/#{params[:topic_id]}"
+        Resend::Request.new(path, params, "patch").perform
+      end
+
+      # https://resend.com/docs/api-reference/topics/list-topics
+      def list(params = {})
+        path = Resend::PaginationHelper.build_paginated_path("topics", params)
+        Resend::Request.new(path, {}, "get").perform
+      end
+
+      # https://resend.com/docs/api-reference/topics/delete-topic
+      def remove(topic_id = "")
+        path = "topics/#{topic_id}"
+        Resend::Request.new(path, {}, "delete").perform
+      end
+    end
+  end
+end

data/lib/resend/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Resend
-  VERSION = "0.25.0"
+  VERSION = "0.27.0.alpha.1"
 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"
@@ -18,6 +20,9 @@ require "resend/batch"
 require "resend/contacts"
 require "resend/domains"
 require "resend/emails"
+require "resend/emails/receiving"
+require "resend/attachments/receiving"
+require "resend/topics"
 
 # Rails
 require "resend/railtie" if defined?(Rails) && defined?(ActionMailer)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: resend
 version: !ruby/object:Gem::Version
-  version: 0.25.0
+  version: 0.27.0.alpha.1
 platform: ruby
 authors:
 - Derich Pacheco
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-20 00:00:00.000000000 Z
+date: 2025-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -47,6 +47,7 @@ files:
 - README.md
 - lib/resend.rb
 - lib/resend/api_keys.rb
+- lib/resend/attachments/receiving.rb
 - lib/resend/audiences.rb
 - lib/resend/batch.rb
 - lib/resend/broadcasts.rb
@@ -54,10 +55,13 @@ files:
 - lib/resend/contacts.rb
 - lib/resend/domains.rb
 - lib/resend/emails.rb
+- lib/resend/emails/receiving.rb
 - lib/resend/errors.rb
 - lib/resend/mailer.rb
+- lib/resend/pagination_helper.rb
 - lib/resend/railtie.rb
 - lib/resend/request.rb
+- lib/resend/topics.rb
 - lib/resend/version.rb
 homepage: https://github.com/resend/resend-ruby
 licenses:
@@ -74,9 +78,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubygems_version: 3.4.10
 signing_key: