email_list_api 0.1.0.rc.5 → 0.1.0.rc.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '08d9df5fadd2f1405fa5e2110df8f0561b0570786b2fbef07b782d8e952a2dd1'
-  data.tar.gz: ef4bdcc6ee092491bec523aba397a13e937e6615111c8efa356b557a9adcaa4d
+  metadata.gz: fd556c4af0aa25954fdad4e7acc5f5c9ef077c182bacb7d395e3145f90ec73fa
+  data.tar.gz: 24dce3a08f06f15eb2341972b5cb2f01b8b07e3ae533a871cc6b82c2a6931b3a
 SHA512:
-  metadata.gz: 4823d66f90179d20ac9a786db1e6593a13946b1d5b29fd192f6a7e6d0b7c7f5db8c7927a3ff9a95e628a33166507f62025c3102754728a39c501fc61feeca8a3
-  data.tar.gz: f454d2dd7e988647e6251239e29da723f6441f08d3f60ca6d6b768f42b8b053b4c636bf5d650c5b548a7904239901381b1e3f1ccba4ed52cf9ef137e4cc1e144
+  metadata.gz: 113f3a7bc9f3ca2c43797ef5b81578479682f0cb2f300ffd0b633c602b1730e96c270a7df5418a8a8a2035d023f5e3679795729ddd7f380343e485810d2dad46
+  data.tar.gz: 5e16ed50c5d2d9ce405f063b649a7986df62fccb0b107ac46c399cfaa6c1863c1a25d7a54c95b6cc6974c36bbfdfbf64a7083d1c142f2b645d6b15c24ccd7ad5

data/README.md

@@ -54,23 +54,29 @@ client = EmailListApi::Client.new(api_key: 'your_api_key', api_version: 1)
 projects = client.projects
 project = client.create_project(name: 'My Project')
 
-# Lists (project can be slug or ID)
-lists = client.lists(project: project['data']['slug'])
-list = client.create_list(project: project['data']['slug'], name: 'Newsletter')
+# Create or update a project (idempotent)
+project = client.upsert_project(name: 'My Project')
+
+# Lists (project must be slug)
+lists = client.lists(project_slug: project['data']['slug'])
+list = client.create_list(project_slug: project['data']['slug'], name: 'Newsletter')
 
 # Contacts
-client.create_contact(project: project['data']['slug'], email: 'user@example.com')
-client.update_contact(project: project['data']['slug'], id: contact_id, first_name: 'John')
+client.create_contact(project_slug: project['data']['slug'], email: 'user@example.com')
+client.update_contact(project_slug: project['data']['slug'], id: contact_id, first_name: 'John')
 # Upsert: creates if new, updates if exists (by email)
-client.upsert_contact(project: project['data']['slug'], email: 'user@example.com', first_name: 'Jane')
+contact = client.upsert_contact(project_slug: project['data']['slug'], email: 'user@example.com', first_name: 'Jane')
+# Access response data using string keys
+contact_id = contact['data']['id']
+email = contact['data']['email']
 
 # Unsubscribe URLs
 # Contact responses include unsubscribe_urls hash (list_id => unsubscribe_url)
-contact = client.contact(project: project['data']['slug'], id: contact_id)
+contact = client.contact(project_slug: project['data']['slug'], id: contact_id)
 contact['data']['unsubscribe_urls'] # => { 1 => "https://emaillist.dev/unsubscribe/...", 2 => "..." }
 
 # List contact responses include unsubscribe_url for that specific list
-list_contacts = client.list_contacts(project: project['data']['slug'], list_id: list_id)
+list_contacts = client.list_contacts(project_slug: project['data']['slug'], list_slug: list['data']['slug'])
 list_contacts['data'].each do |contact|
   unsubscribe_url = contact['unsubscribe_url'] # => "https://emaillist.dev/unsubscribe/..."
   # Include this URL in your email templates

data/lib/email_list_api/client.rb

@@ -41,8 +41,8 @@ module EmailListApi
       get("projects")
     end
 
-    def project(id)
-      get("projects/#{id}")
+    def project(slug:)
+      get("projects/#{slug}")
     end
 
     def create_project(name:, description: nil)
@@ -53,103 +53,103 @@ module EmailListApi
       post("projects/upsert", { project: { name: name, description: description } })
     end
 
-    def update_project(id, name: nil, description: nil)
+    def update_project(slug:, name: nil, description: nil)
       params = { project: {} }
       params[:project][:name] = name if name
       params[:project][:description] = description if description
-      patch("projects/#{id}", params)
+      patch("projects/#{slug}", params)
     end
 
-    def delete_project(id)
-      delete("projects/#{id}")
+    def delete_project(slug:)
+      delete("projects/#{slug}")
     end
 
     # Lists
-    def lists(project:)
-      get("projects/#{project}/lists")
+    def lists(project_slug:)
+      get("projects/#{project_slug}/lists")
     end
 
-    def list(project:, slug:)
-      get("projects/#{project}/lists/#{slug}")
+    def list(project_slug:, slug:)
+      get("projects/#{project_slug}/lists/#{slug}")
     end
 
-    def create_list(project:, name:, description: nil)
-      post("projects/#{project}/lists", { list: { name: name, description: description } })
+    def create_list(project_slug:, name:, description: nil)
+      post("projects/#{project_slug}/lists", { list: { name: name, description: description } })
     end
 
-    def upsert_list(project:, name:, description: nil)
-      post("projects/#{project}/lists/upsert", { list: { name: name, description: description } })
+    def upsert_list(project_slug:, name:, description: nil)
+      post("projects/#{project_slug}/lists/upsert", { list: { name: name, description: description } })
     end
 
-    def update_list(project:, slug:, name: nil, description: nil)
+    def update_list(project_slug:, slug:, name: nil, description: nil)
       params = { list: {} }
       params[:list][:name] = name if name
       params[:list][:description] = description if description
-      patch("projects/#{project}/lists/#{slug}", params)
+      patch("projects/#{project_slug}/lists/#{slug}", params)
     end
 
-    def delete_list(project:, slug:)
-      delete("projects/#{project}/lists/#{slug}")
+    def delete_list(project_slug:, slug:)
+      delete("projects/#{project_slug}/lists/#{slug}")
     end
 
     # Contacts
-    def contacts(project:, page: 1)
-      get("projects/#{project}/contacts", { page: page })
+    def contacts(project_slug:, page: 1)
+      get("projects/#{project_slug}/contacts", { page: page })
     end
 
-    def contact(project:, id:)
-      get("projects/#{project}/contacts/#{id}")
+    def contact(project_slug:, id:)
+      get("projects/#{project_slug}/contacts/#{id}")
     end
 
-    def create_contact(project:, email:, first_name: nil, last_name: nil)
+    def create_contact(project_slug:, email:, first_name: nil, last_name: nil)
       params = { contact: { email: email } }
       params[:contact][:first_name] = first_name if first_name
       params[:contact][:last_name] = last_name if last_name
-      post("projects/#{project}/contacts", params)
+      post("projects/#{project_slug}/contacts", params)
     end
 
-    def update_contact(project:, id:, email: nil, first_name: nil, last_name: nil)
+    def update_contact(project_slug:, id:, email: nil, first_name: nil, last_name: nil)
       params = { contact: {} }
       params[:contact][:email] = email if email
       params[:contact][:first_name] = first_name if first_name
       params[:contact][:last_name] = last_name if last_name
-      patch("projects/#{project}/contacts/#{id}", params)
+      patch("projects/#{project_slug}/contacts/#{id}", params)
     end
 
-    def upsert_contact(project:, email:, first_name: nil, last_name: nil)
+    def upsert_contact(project_slug:, email:, first_name: nil, last_name: nil)
       params = { contact: { email: email } }
       params[:contact][:first_name] = first_name if first_name
       params[:contact][:last_name] = last_name if last_name
-      post("projects/#{project}/contacts/upsert", params)
+      post("projects/#{project_slug}/contacts/upsert", params)
     end
 
-    def delete_contact(project:, id:)
-      delete("projects/#{project}/contacts/#{id}")
+    def delete_contact(project_slug:, id:)
+      delete("projects/#{project_slug}/contacts/#{id}")
     end
 
     # List Memberships
-    def list_contacts(project:, list_slug:)
-      get("projects/#{project}/lists/#{list_slug}/contacts")
+    def list_contacts(project_slug:, list_slug:)
+      get("projects/#{project_slug}/lists/#{list_slug}/contacts")
     end
 
-    def add_contacts_to_list(project:, list_slug:, contacts:)
+    def add_contacts_to_list(project_slug:, list_slug:, contacts:)
       # contacts can be an array of hashes or a single hash, but API expects array
       contacts = [ contacts ] unless contacts.is_a?(Array)
-      post("projects/#{project}/lists/#{list_slug}/contacts", { contacts: contacts })
+      post("projects/#{project_slug}/lists/#{list_slug}/contacts", { contacts: contacts })
     end
 
-    def add_contact_to_list(project:, list_slug:, contact_id:)
+    def add_contact_to_list(project_slug:, list_slug:, contact_id:)
       # Helper for adding single existing contact by ID
-      add_contacts_to_list(project: project, list_slug: list_slug, contacts: [ { id: contact_id } ])
+      add_contacts_to_list(project_slug: project_slug, list_slug: list_slug, contacts: [ { id: contact_id } ])
     end
 
-    def remove_contact_from_list(project:, list_slug:, contact_id:)
-      delete("projects/#{project}/lists/#{list_slug}/contacts/#{contact_id}")
+    def remove_contact_from_list(project_slug:, list_slug:, contact_id:)
+      delete("projects/#{project_slug}/lists/#{list_slug}/contacts/#{contact_id}")
     end
 
     # Bulk Operations
-    def bulk_create_contacts(project:, contacts:)
-       post("projects/#{project}/contacts/bulk", { contacts: contacts })
+    def bulk_create_contacts(project_slug:, contacts:)
+       post("projects/#{project_slug}/contacts/bulk", { contacts: contacts })
     end
 
     private

data/lib/email_list_api/syncs_email_list_contact.rb

@@ -120,15 +120,15 @@ module EmailListApi
 
         # Upsert contact (creates if new, updates if exists)
         contact = emaillist_client.upsert_contact(
-          project: project_slug,
+          project_slug: project_slug,
           email: email,
           first_name: first_name,
           last_name: last_name
         )
 
         # Optionally store the contact_id if column exists
-        if respond_to?(:emaillist_contact_id=) && contact && contact[:data]
-          contact_id = contact[:data][:id]
+        if respond_to?(:emaillist_contact_id=) && contact && contact['data']
+          contact_id = contact['data']['id']
           update_column(:emaillist_contact_id, contact_id) if persisted? && contact_id
         end
       rescue => e

data/lib/email_list_api/version.rb

@@ -1,3 +1,3 @@
 module EmailListApi
-  VERSION = "0.1.0.rc.5"
+  VERSION = "0.1.0.rc.6"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: email_list_api
 version: !ruby/object:Gem::Version
-  version: 0.1.0.rc.5
+  version: 0.1.0.rc.6
 platform: ruby
 authors:
 - Email List Dev