resend 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9388a0e6d79027b6f057669d807519fdb74433d89eafc50bd0a4db5d4626e7a5
-  data.tar.gz: 321c0387aa19dbf95b930ad5a79a00e40d09757714250aa44845b0f7e912efb4
+  metadata.gz: 67dadb5f7acb77801501030612149bf52b6c46626fd5630a233a77ab6fc552d7
+  data.tar.gz: 8842020484f59a566282b8ff1258bfeea02594274b2f117c548ae2ad49284ad2
 SHA512:
-  metadata.gz: 51e5ffc36f521db854067a10d6bb2e0e90d45837237177bb5620ff189b015595695b55c122cccefd020f4dae2d23c6cca7221c4ee7346863eda3c05a297c8740
-  data.tar.gz: 80637728c8fb04c3e521b79fd444cb3f92554062312070e324004863ee914fcea4da7d13be832ae6c4abcabedab0521e20e16e32dd778633a8a7169fb0d57732
+  metadata.gz: d889989325170107795bed29b590b45382909a8b4812381c4fa330e8c94c6cf7d8c3be1474793c0b6a93c85fc3f0647fd868f5b540902cd9e6ca260821f3b5ec
+  data.tar.gz: 48ec677afd58504f02b4099fb1f4d926defa2aa64f05cb2d8e8e1c724b08f1d1b3950f79535ac89481a8f58f1b1884962c4e46247bbdb6b03e0364325822fab9

data/lib/resend/broadcasts.rb

@@ -7,6 +7,9 @@ module Resend
       # https://resend.com/docs/api-reference/broadcasts/create-broadcast
       # @note Supports both segment_id and audience_id. At least one is required.
       #   audience_id is deprecated - use segment_id instead.
+      # @note When send: true is passed, the broadcast is sent immediately instead of
+      #   creating a draft. When using send: true, you can also include scheduled_at
+      #   to schedule the broadcast. Passing scheduled_at without send: true is an error.
       def create(params = {})
         if params[:audience_id] && !params[:segment_id]
           warn "[DEPRECATION] Using audience_id in broadcasts is deprecated. Use segment_id instead."

data/lib/resend/mailer.rb

@@ -14,7 +14,7 @@ module Resend
       cc bcc
       from reply-to to subject mime-version
       html text
-      content-type tags scheduled_at
+      content-type content-transfer-encoding tags scheduled_at
       headers options
     ].freeze
 

data/lib/resend/request.rb

@@ -34,13 +34,16 @@ module Resend
       resp = HTTParty.send(@verb.to_sym, "#{BASE_URL}#{@path}", options)
 
       check_json!(resp)
-      process_response(resp)
+      data = process_response(resp)
+      headers = extract_headers(resp)
+
+      Resend::Response.new(data, headers)
     end
 
-    def handle_error!(resp)
-      code = resp[:statusCode]
-      body = resp[:message]
-      headers = resp.respond_to?(:headers) ? resp.headers : (resp[:headers] || {})
+    def handle_error!(data, resp = nil)
+      code = data[:statusCode]
+      body = data[:message]
+      headers = resp.respond_to?(:headers) ? resp.headers : (data[:headers] || {})
 
       # get error from the known list of errors
       error_class = Resend::Error::ERRORS[code] || Resend::Error
@@ -66,20 +69,23 @@ module Resend
     end
 
     def process_response(resp)
-      resp.transform_keys!(&:to_sym) unless resp.body.empty?
-      handle_error!(resp) if error_response?(resp)
-      resp
+      # Extract the parsed data from HTTParty response or use the hash directly (for tests/mocks)
+      data = resp.respond_to?(:parsed_response) ? resp.parsed_response : resp
+      data ||= {}
+      data.transform_keys!(&:to_sym) unless resp.body.empty?
+      handle_error!(data, resp) if error_response?(data)
+      data
     end
 
     def error_response?(resp)
-      resp[:statusCode] && (resp[:statusCode] != 200 && resp[:statusCode] != 201)
+      resp[:statusCode] && resp[:statusCode] != 200 && resp[:statusCode] != 201
     end
 
     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?)
+      if @verb.downcase == "post" && !@options[:idempotency_key].nil? && !@options[:idempotency_key].empty?
         @headers["Idempotency-Key"] = @options[:idempotency_key]
       end
     end
@@ -101,5 +107,12 @@ module Resend
     rescue JSON::ParserError, TypeError
       raise Resend::Error::InternalServerError.new("Resend API returned an unexpected response", nil)
     end
+
+    # Extract and normalize headers from the HTTParty response
+    def extract_headers(resp)
+      return {} unless resp.respond_to?(:headers)
+
+      resp.headers.to_h.transform_keys { |k| k.to_s.downcase }
+    end
   end
 end

data/lib/resend/response.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+module Resend
+  # Response wrapper that maintains backwards compatibility while exposing headers
+  #
+  # This class wraps API responses and behaves like a Hash for backwards compatibility,
+  # while also providing access to response headers via the #headers method.
+  #
+  # @example Backwards compatible hash access
+  #   response = Resend::Emails.send(params)
+  #   response[:id]  # => "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794"
+  #
+  # @example Accessing response headers
+  #   response = Resend::Emails.send(params)
+  #   response.headers  # => {"content-type" => "application/json", ...}
+  #   response.headers['x-ratelimit-remaining']  # => "50"
+  class Response
+    include Enumerable
+
+    # @param data [Hash] The response data
+    # @param headers [Hash, HTTParty::Response] The response headers
+    def initialize(data, headers)
+      @data = data.is_a?(Hash) ? data : {}
+      @headers = normalize_headers(headers)
+    end
+
+    # Access response headers
+    # @return [Hash] Response headers as a hash with lowercase string keys
+    attr_reader :headers
+
+    # Hash-like access via []
+    # @param key [Symbol, String] The key to access
+    # @return [Object] The value at the key
+    def [](key)
+      @data[key]
+    end
+
+    # Hash-like assignment via []=
+    # @param key [Symbol, String] The key to set
+    # @param value [Object] The value to set
+    def []=(key, value)
+      @data[key] = value
+    end
+
+    # Dig into nested hash structure
+    # @param keys [Array<Symbol, String>] Keys to dig through
+    # @return [Object] The value at the nested key path
+    def dig(*keys)
+      @data.dig(*keys)
+    end
+
+    # Convert to plain hash
+    # @return [Hash] The underlying data hash
+    def to_h
+      @data
+    end
+
+    alias to_hash to_h
+
+    # Get all keys from the data
+    # @return [Array] Array of keys
+    def keys
+      @data.keys
+    end
+
+    # Get all values from the data
+    # @return [Array] Array of values
+    def values
+      @data.values
+    end
+
+    # Check if key exists
+    # @param key [Symbol, String] The key to check
+    # @return [Boolean] True if key exists
+    def key?(key)
+      @data.key?(key)
+    end
+
+    alias has_key? key?
+
+    # Enable enumeration over the data
+    def each(&block)
+      @data.each(&block)
+    end
+
+    # Transform keys in the underlying data
+    # @return [Resend::Response] Self for chaining
+    def transform_keys!(&block)
+      @data.transform_keys!(&block)
+      self
+    end
+
+    # Check if response is empty
+    # @return [Boolean] True if data is empty
+    def empty?
+      @data.empty?
+    end
+
+    # Respond to hash-like methods
+    def respond_to_missing?(method_name, include_private = false)
+      @data.respond_to?(method_name) || super
+    end
+
+    # Delegate unknown methods to the underlying data hash
+    def method_missing(method_name, *args, &block)
+      if @data.respond_to?(method_name)
+        result = @data.send(method_name, *args, &block)
+        # If the method returns the hash itself, return self to maintain wrapper
+        result.equal?(@data) ? self : result
+      else
+        super
+      end
+    end
+
+    # String representation for debugging
+    # @return [String] String representation of the response
+    def inspect
+      "#<Resend::Response data=#{@data.inspect} headers=#{@headers.keys.inspect}>"
+    end
+
+    private
+
+    # Normalize headers to a simple hash with lowercase string keys
+    # @param headers [Hash, HTTParty::Response, nil] The headers to normalize
+    # @return [Hash] Normalized headers hash
+    def normalize_headers(headers)
+      return {} if headers.nil?
+
+      # Handle HTTParty::Response object
+      headers = headers.headers if headers.respond_to?(:headers)
+
+      # Convert to hash and normalize keys to lowercase strings
+      case headers
+      when Hash
+        headers.to_h.transform_keys { |k| k.to_s.downcase }
+      else
+        {}
+      end
+    end
+  end
+end

data/lib/resend/version.rb

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

data/lib/resend.rb

@@ -8,6 +8,7 @@ require "httparty"
 require "json"
 require "cgi"
 require "resend/errors"
+require "resend/response"
 require "resend/client"
 require "resend/request"
 require "resend/pagination_helper"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: resend
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Derich Pacheco
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-10-31 00:00:00.000000000 Z
+date: 2026-02-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -38,7 +38,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description:
+description: 
 email: carlosderich@gmail.com
 executables: []
 extensions: []
@@ -65,6 +65,7 @@ files:
 - lib/resend/pagination_helper.rb
 - lib/resend/railtie.rb
 - lib/resend/request.rb
+- lib/resend/response.rb
 - lib/resend/segments.rb
 - lib/resend/templates.rb
 - lib/resend/topics.rb
@@ -74,7 +75,7 @@ homepage: https://github.com/resend/resend-ruby
 licenses:
 - MIT
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -89,8 +90,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
-signing_key:
+rubygems_version: 3.0.3.1
+signing_key: 
 specification_version: 4
 summary: The Ruby and Rails SDK for resend.com
 test_files: []