resend 1.4.0 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5bac6323a992135612079621a1d9933831c44e6202838cff57377397c2214f2c
-  data.tar.gz: c584c139bad503543f7cad52639f9dc6fe86812da1550b38729cd96638b9988b
+  metadata.gz: a131df322ae7ac448440742ce3cda1487b763a094f1940710236cc1e4f76534d
+  data.tar.gz: bb824f2076b51bf7eb82dd9a75ba4bd86c2d15162e8a499ef6b6e66555c37b2b
 SHA512:
-  metadata.gz: 4411842066220cc450056f799a94d6cba513a6bf5c0c67c8f467e68e1cc8320911c3f47f983ec32430dc09961d4e005fb1f1ce429997b2ae5be5045eb7b85de6
-  data.tar.gz: '0586cc9b333744f728d34847cc7de9bb18109b5658e870354f3b6a69b1988d4366e0bf4f37e3564a6a63f16de9e33f1070b3f15410be0dc88a996e8d3eff9336'
+  metadata.gz: 01efcf455f3b05c468ee1aede05bfeae5d7040b3dae1b2faf6bc38571b422b273a097f1b7eeb41cdc6fcc55f0c2b2f81eb4718814897a982c61915b52aae7a15
+  data.tar.gz: 4259936777bb6815e5abca38babf4b399efe5e2a0dfa55d87e2b1536b9f85b344683e0e9ee84ef21978630ad4e41dd6bc709d59bb5def667b412a37781af86df

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/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/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Resend
-  VERSION = "1.4.0"
+  VERSION = "1.5.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,6 +20,7 @@ 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"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: resend
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.5.0
 platform: ruby
 authors:
 - Derich Pacheco
@@ -53,6 +53,7 @@ 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
@@ -64,6 +65,7 @@ files:
 - lib/resend/events.rb
 - lib/resend/logs.rb
 - lib/resend/mailer.rb
+- lib/resend/multipart_request.rb
 - lib/resend/pagination_helper.rb
 - lib/resend/railtie.rb
 - lib/resend/request.rb