feat: Update contact by email (#93)

Author: drish

examples/contacts.rb

@@ -23,8 +23,10 @@ def example
 
   update_params = {
     audience_id: audience_id,
-    id: contact[:id],
-    unsubscribed: true,
+    email: params[:email],
+    # id: contact[:id],
+    unsubscribed: false,
+    first_name: "Updated",
   }
 
   retrieved = Resend::Contacts.get(audience_id, contact[:id])

lib/resend/contacts.rb

@@ -19,6 +19,10 @@ def get(audience_id, id)
         Resend::Request.new(path, {}, "get").perform
       end
 
+      #
+      # List contacts in an audience
+      #
+      # @param audience_id [String] the audience id
       # https://resend.com/docs/api-reference/contacts/list-contacts
       def list(audience_id)
         path = "audiences/#{audience_id}/contacts"
@@ -37,9 +41,15 @@ def remove(audience_id, contact_id)
         Resend::Request.new(path, {}, "delete").perform
       end
 
+      #
+      # Update a contact
+      #
+      # @param params [Hash] the contact params
       # https://resend.com/docs/api-reference/contacts/update-contact
       def update(params)
-        path = "audiences/#{params[:audience_id]}/contacts/#{params[:id]}"
+        raise ArgumentError, "id or email is required" if params[:id].nil? && params[:email].nil?
+
+        path = "audiences/#{params[:audience_id]}/contacts/#{params[:id] || params[:email]}"
         Resend::Request.new(path, params, "patch").perform
       end
     end

spec/contacts_spec.rb

@@ -136,5 +136,13 @@
       expect(contact[:id]).to eql("479e3145-dd38-476b-932c-529ceb705947")
       expect(contact[:object]).to eql("contact")
     end
+
+    it "raise when required fields are not provided" do
+      begin
+        Resend::Contacts.update({ audience_id: "123" })
+      rescue ArgumentError => e
+        expect(e.message).to eql("id or email is required")
+      end
+    end
   end
 end