email_list_api 0.1.0.rc.4 → 0.1.0.rc.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 40ee3e78d98766e82df1c5f66b68d07de97296e9204ad7c121b996b1a8c8720f
-  data.tar.gz: 8269b928eb9d98df12771bada12b33d351c9db2f92e11716a298143c1b757946
+  metadata.gz: fd556c4af0aa25954fdad4e7acc5f5c9ef077c182bacb7d395e3145f90ec73fa
+  data.tar.gz: 24dce3a08f06f15eb2341972b5cb2f01b8b07e3ae533a871cc6b82c2a6931b3a
 SHA512:
-  metadata.gz: 70e6101f5777e6b8339dff5b16be8c5b746a1ac078a28dcfe57478f3a24d9fbed28b52803157e70df32a2fdf865937c0e7136875218d50ff7134a4b616d4230e
-  data.tar.gz: 1c6b432fcb1fa03f464860cf2b176d3538e8f3909da35e22c9b2002ad9d912df395b236b7ba0fbdc1667921c3d0a7229e84b0548bb1748a6eb9073998d33172a
+  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

@@ -17,21 +17,8 @@ module EmailListApi
     private
 
     def build_url_parts(base_url_override = nil)
-      # Priority: explicit parameter > config > environment detection > production default
-      base_url = base_url_override || EmailListApi.configuration.base_url
-
-      # If still not set, try to detect environment and use appropriate default
-      if base_url.nil?
-        # Check if Rails is available and use environment-based default
-        if defined?(Rails) && Rails.env.development?
-          base_url = DEVELOPMENT_BASE_URL
-        elsif defined?(Rails) && Rails.env.test?
-          base_url = DEVELOPMENT_BASE_URL
-        else
-          # Default to production for all other cases
-          base_url = PRODUCTION_BASE_URL
-        end
-      end
+      # Priority: explicit parameter > config > production default
+      base_url = base_url_override || EmailListApi.configuration.base_url || PRODUCTION_BASE_URL
 
       raise ArgumentError, "base_url must be configured" unless base_url
 
@@ -54,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)
@@ -66,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.4"
+  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.4
+  version: 0.1.0.rc.6
 platform: ruby
 authors:
 - Email List Dev
@@ -94,12 +94,12 @@ files:
 - lib/email_list_api/configuration.rb
 - lib/email_list_api/syncs_email_list_contact.rb
 - lib/email_list_api/version.rb
-homepage: https://emaillist.dev/docs
+homepage: https://emaillist.dev
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://emaillist.dev/docs
+  homepage_uri: https://emaillist.dev
 rdoc_options: []
 require_paths:
 - lib