resend 1.4.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5bac6323a992135612079621a1d9933831c44e6202838cff57377397c2214f2c
-  data.tar.gz: c584c139bad503543f7cad52639f9dc6fe86812da1550b38729cd96638b9988b
+  metadata.gz: 23a4b97089acf88e3b1a768ebb7b9db1c5733ea1b225ca94cdeaae55abe4d0bc
+  data.tar.gz: 24e7052354d80707fe5d1d4aafeac46b85926deec93089f853c11c22965501a8
 SHA512:
-  metadata.gz: 4411842066220cc450056f799a94d6cba513a6bf5c0c67c8f467e68e1cc8320911c3f47f983ec32430dc09961d4e005fb1f1ce429997b2ae5be5045eb7b85de6
-  data.tar.gz: '0586cc9b333744f728d34847cc7de9bb18109b5658e870354f3b6a69b1988d4366e0bf4f37e3564a6a63f16de9e33f1070b3f15410be0dc88a996e8d3eff9336'
+  metadata.gz: df538ce18a8a477d1527a270088691c98c5c2f1f6a793502f6abafd605f04e47a9c23b7366a7ef6c694c90ec4804ac2a909d8288d80c61062af7dc179c7d8d33
+  data.tar.gz: 73cbbda1da1cf01ebdb93c5f542481a6e33bebd2ae9d7a2ddbe696fac3d6ff550f2f270e3ce805fb72546a0af72557826dcf9c74509205c14935dfa49f8cb817

data/CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.6.0] - 2026-07-09
+
+### Added
+
+- **OAuth grants** - New `Resend::OAuthGrants` module to list (`GET /oauth/grants`) and revoke (`DELETE /oauth/grants/:id`) OAuth grants. `list` supports the standard `limit`/`after`/`before` pagination params. ([#197](https://github.com/resend/resend-ruby/pull/197))
+- **Domain claims** - New `Resend::Domains::Claims` module to claim a domain verified by another account (`create`), retrieve the latest claim (`get`), and trigger verification/ownership transfer (`verify`). ([#194](https://github.com/resend/resend-ruby/pull/194))
+
 ## [1.0.0] - 2025-10-31
 
 ### Overview

data/lib/resend/contacts/imports.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Resend
+  module Contacts
+    # Contact Imports API wrapper
+    module Imports
+      class << self
+        #
+        # Create a new contact import from a CSV file.
+        #
+        # @param params [Hash] the parameters
+        # @option params [String, IO] :file CSV file content (required). Maximum size is 50MB.
+        # @option params [Hash, String] :column_map optional mapping of contact fields to CSV columns.
+        #   Accepts a Hash (will be JSON-encoded) or a pre-encoded JSON String.
+        # @option params [String] :on_conflict optional conflict strategy: 'upsert' or 'skip' (default 'skip').
+        # @option params [Array, String] :segments optional list of segment IDs to add contacts to.
+        #   Accepts an Array of segment ID strings (will be JSON-encoded as [{"id":"..."}])
+        #   or a pre-encoded JSON String.
+        # @option params [Array, String] :topics optional list of topic subscription objects.
+        #   Each element must be a Hash with `id` (String) and `subscription` ('opt_in' or 'opt_out').
+        #   Accepts an Array of Hashes (will be JSON-encoded) or a pre-encoded JSON String.
+        #
+        # https://resend.com/docs/api-reference/contacts/create-contact-import
+        def create(params)
+          raise ArgumentError, "Missing required `file` field" if params[:file].nil?
+
+          # Normalize segments: convert array of IDs to [{id: ...}] format
+          if params[:segments].is_a?(Array)
+            params = params.merge(segments: params[:segments].map { |s| s.is_a?(String) ? { id: s } : s })
+          end
+
+          Resend::MultipartRequest.new("contacts/imports", params, "post").perform
+        end
+
+        #
+        # Retrieve a single contact import by ID.
+        #
+        # @param id [String] the contact import ID (required)
+        #
+        # https://resend.com/docs/api-reference/contacts/get-contact-import
+        def get(id)
+          raise ArgumentError, "Missing required `id` field" if id.nil? || id.empty?
+
+          Resend::Request.new("contacts/imports/#{id}", {}, "get").perform
+        end
+
+        #
+        # Retrieve a list of contact imports.
+        #
+        # @param params [Hash] optional filtering and pagination parameters
+        # @option params [String] :status filter by status: 'queued', 'in_progress', 'completed', or 'failed'
+        # @option params [Integer] :limit number of results to return
+        # @option params [String] :after cursor for forward pagination
+        # @option params [String] :before cursor for backward pagination
+        #
+        # https://resend.com/docs/api-reference/contacts/list-contact-imports
+        def list(params = {})
+          path = Resend::PaginationHelper.build_paginated_path("contacts/imports", params)
+          Resend::Request.new(path, {}, "get").perform
+        end
+      end
+    end
+  end
+end

data/lib/resend/domains/claims.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Resend
+  module Domains
+    # Domain Claims API wrapper
+    module Claims
+      class << self
+        #
+        # Start a claim for a domain that another Resend account has already verified.
+        # The domain is recreated under your account with fresh DKIM keys, so the
+        # previous account's DNS records cannot be reused. Returns a TXT record to add
+        # to your DNS to prove ownership. Uses the same request body as creating a domain.
+        #
+        # @param params [Hash] the parameters
+        # @option params [String] :name the name of the domain you want to claim (required)
+        # @option params [String] :region the region where emails will be sent from.
+        #   Possible values: 'us-east-1' | 'eu-west-1' | 'sa-east-1' | 'ap-northeast-1'
+        # @option params [String] :custom_return_path subdomain for the Return-Path address (default 'send')
+        # @option params [String] :tracking_subdomain the custom subdomain used for click and open tracking links
+        # @option params [Boolean] :click_tracking track clicks within the body of each HTML email
+        # @option params [Boolean] :open_tracking track the open rate of each email
+        #
+        # https://resend.com/docs/api-reference/domains/claim-domain
+        def create(params)
+          path = "domains/claim"
+          Resend::Request.new(path, params, "post").perform
+        end
+
+        #
+        # Retrieve the latest claim for the placeholder domain created by the claim.
+        #
+        # @param domain_id [String] the ID of the placeholder domain created by the claim
+        #
+        # https://resend.com/docs/api-reference/domains/get-domain-claim
+        def get(domain_id = "")
+          path = "domains/#{domain_id}/claim"
+          Resend::Request.new(path, {}, "get").perform
+        end
+
+        #
+        # Trigger asynchronous DNS verification and ownership transfer for a domain claim.
+        # The claim stays 'pending' while verification runs; poll `get` for status. Once
+        # 'completed', the transferred domain has new DKIM records that must be added to
+        # DNS and verified via Resend::Domains.verify.
+        #
+        # @param domain_id [String] the ID of the placeholder domain created by the claim
+        #
+        # https://resend.com/docs/api-reference/domains/verify-domain-claim
+        def verify(domain_id = "")
+          path = "domains/#{domain_id}/claim/verify"
+          Resend::Request.new(path, {}, "post").perform
+        end
+      end
+    end
+  end
+end

data/lib/resend/multipart_request.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require "securerandom"
+
+module Resend
+  # Handles multipart/form-data requests (file uploads).
+  # Builds the multipart body directly instead of relying on HTTParty's
+  # duck-typing file detection, which requires a :path method.
+  class MultipartRequest < Request
+    NEWLINE = "\r\n"
+    private_constant :NEWLINE
+
+    private
+
+    def build_request_options
+      boundary = SecureRandom.hex(16)
+      headers = @headers.merge("Content-Type" => "multipart/form-data; boundary=#{boundary}")
+      { headers: headers, body: build_multipart_body(boundary) }
+    end
+
+    def build_multipart_body(boundary)
+      body = "".b
+
+      body << part(boundary, "file", read_file(@body[:file]), filename: "import.csv", content_type: "text/csv")
+      optional_fields.each { |name, value| body << part(boundary, name, value) }
+      body << "--#{boundary}--#{NEWLINE}".b
+
+      body
+    end
+
+    def part(boundary, name, value, filename: nil, content_type: nil)
+      disposition = %(Content-Disposition: form-data; name="#{name}")
+      disposition += %(; filename="#{filename}") if filename
+
+      header = "--#{boundary}#{NEWLINE}#{disposition}#{NEWLINE}"
+      header += "Content-Type: #{content_type}#{NEWLINE}" if content_type
+      header += NEWLINE
+
+      header.b + value.to_s.b + NEWLINE.b
+    end
+
+    def read_file(file_data)
+      if file_data.respond_to?(:read)
+        content = file_data.read
+        file_data.rewind if file_data.respond_to?(:rewind)
+        content.b
+      else
+        file_data.to_s.b
+      end
+    end
+
+    def optional_fields
+      {
+        column_map: @body[:column_map] && serialize_json(@body[:column_map]),
+        on_conflict: @body[:on_conflict],
+        segments: @body[:segments] && serialize_json(@body[:segments]),
+        topics: @body[:topics] && serialize_json(@body[:topics])
+      }.compact
+    end
+
+    def serialize_json(value)
+      return value if value.is_a?(String)
+
+      value.to_json
+    end
+  end
+end

data/lib/resend/oauth_grants.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Resend
+  # oauth grants api wrapper
+  module OAuthGrants
+    class << self
+      # https://resend.com/docs/api-reference/oauth/list-grants
+      def list(params = {})
+        path = Resend::PaginationHelper.build_paginated_path("oauth/grants", params)
+        Resend::Request.new(path, {}, "get").perform
+      end
+
+      # https://resend.com/docs/api-reference/oauth/revoke-grant
+      def revoke(oauth_grant_id = "")
+        path = "oauth/grants/#{oauth_grant_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 = "1.4.0"
+  VERSION = "1.6.0"
 end

data/lib/resend.rb

@@ -11,6 +11,7 @@ require "resend/errors"
 require "resend/response"
 require "resend/client"
 require "resend/request"
+require "resend/multipart_request"
 require "resend/pagination_helper"
 
 # API Operations
@@ -19,10 +20,12 @@ require "resend/api_keys"
 require "resend/broadcasts"
 require "resend/batch"
 require "resend/contacts"
+require "resend/contacts/imports"
 require "resend/contacts/segments"
 require "resend/contacts/topics"
 require "resend/contact_properties"
 require "resend/domains"
+require "resend/domains/claims"
 require "resend/emails"
 require "resend/templates"
 require "resend/emails/receiving"
@@ -31,6 +34,7 @@ require "resend/emails/receiving/attachments"
 require "resend/logs"
 require "resend/topics"
 require "resend/webhooks"
+require "resend/oauth_grants"
 require "resend/automations"
 require "resend/automations/runs"
 require "resend/events"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: resend
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.6.0
 platform: ruby
 authors:
 - Derich Pacheco
@@ -53,9 +53,11 @@ files:
 - lib/resend/client.rb
 - lib/resend/contact_properties.rb
 - lib/resend/contacts.rb
+- lib/resend/contacts/imports.rb
 - lib/resend/contacts/segments.rb
 - lib/resend/contacts/topics.rb
 - lib/resend/domains.rb
+- lib/resend/domains/claims.rb
 - lib/resend/emails.rb
 - lib/resend/emails/attachments.rb
 - lib/resend/emails/receiving.rb
@@ -64,6 +66,8 @@ files:
 - lib/resend/events.rb
 - lib/resend/logs.rb
 - lib/resend/mailer.rb
+- lib/resend/multipart_request.rb
+- lib/resend/oauth_grants.rb
 - lib/resend/pagination_helper.rb
 - lib/resend/railtie.rb
 - lib/resend/request.rb