keplars 2.1.0 → 2.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0cf4cf268e788b45d71a89a6fdeebfc472a8a051e4ef361fc50704445829d784
-  data.tar.gz: a91eb6cc0fd9769f9cc72c79877ea08f60a4711994a4b65bc3ea163e8dbb8a82
+  metadata.gz: 34db333b47bda0dbd67ccd1173e40bba96006f5760ea039f909cff188f2baedf
+  data.tar.gz: abd282d486bd30dbed467b4f458c59cefadb5e466824c3e524840a1bb7db9483
 SHA512:
-  metadata.gz: 43bc8dd44d4000e4faae494f29963016fa10851ae2a70ae71febad694b8fe31bba334af131644103fe8d36e6902ef721cdcc9f65e9755764ba69c8923bb59d71
-  data.tar.gz: 0af7402b88f4a3bbcd13c253174c509d5bf3e5b433256b7851c50a8c9e4e75ef1fb91d3f66fd84e1d2e01fae2f187d7cfcf9df3d5e292237324a70f7b37d3dd1
+  metadata.gz: 4555943f4670d58e9ecaa4d9b1c54ceb3fc91fac339f81956554252d253c517acab48f875d6b107ad3e852cecb5a84a91ce13b11e0fcc1b1edf68f3192273f41
+  data.tar.gz: 921934717da2466ac5c74f2c39e9cf61394d85e42c83eb1ff47c5b6a766c5a8baa160e960b29c4dcc08c09021a96ed905bd62677e4416ecf338abdb770ac7f84

data/lib/keplars/audiences.rb

@@ -7,10 +7,12 @@ module Keplars
         @client.request('POST', '/api/v1/public/audiences/add-audience', body: body)[:data]
       end
 
-      def list(page: nil, limit: nil)
+      def list(page: nil, limit: nil, sort_by: nil, sort_dir: nil)
         params = {}
         params[:page] = page if page
         params[:limit] = limit if limit
+        params[:sortBy] = sort_by if sort_by
+        params[:sortDir] = sort_dir if sort_dir
 
         query = @client.send(:build_query_string, params)
         @client.request('GET', "/api/v1/public/audiences/get-audiences#{query}")[:data]

data/lib/keplars/automations.rb

@@ -14,13 +14,21 @@ module Keplars
         @client.request('GET', "/api/v1/public/automations/get-automation/#{id}")[:data]
       end
 
-      def enroll(id, email:)
-        @client.request('POST', "/api/v1/public/automations/add-automation/#{id}/enroll", body: { email: email })[:data]
+      def enroll(id, email:, properties: nil)
+        body = { email: email }
+        body[:properties] = properties if properties
+        @client.request('POST', "/api/v1/public/automations/add-automation/#{id}/enroll", body: body)[:data]
       end
 
       def unenroll(id, email:)
         @client.request('DELETE', "/api/v1/public/automations/delete-automation/#{id}/subscribers", body: { email: email })[:data]
       end
+
+      def track_event(email, event_name, event_properties: nil)
+        body = { email: email, event_name: event_name }
+        body[:event_properties] = event_properties if event_properties
+        @client.request('POST', '/api/v1/public/automations/events/track', body: body)[:data]
+      end
     end
   end
 end

data/lib/keplars/client.rb

@@ -66,6 +66,8 @@ module Keplars
 
         result = response.body && !response.body.empty? ? JSON.parse(response.body, symbolize_names: true) : nil
         { data: result, rate_limit_info: rate_limit_info }
+      rescue KeplarsError
+        raise
       rescue StandardError => e
         if retryable_error?(e) && retry_count < @max_retries
           delay = calculate_backoff(retry_count)

data/lib/keplars/contacts.rb

@@ -5,26 +5,42 @@ module Keplars
         @client.request('POST', '/api/v1/public/contacts/add-contact', body: params.compact)[:data]
       end
 
-      def get(email)
-        @client.request('GET', "/api/v1/public/contacts/get-contact?email=#{URI.encode_www_form_component(email)}")[:data]
+      def get(email_or_id)
+        param = email_or_id.include?('@') ? 'email' : 'id'
+        @client.request('GET', "/api/v1/public/contacts/get-contact?#{param}=#{URI.encode_www_form_component(email_or_id)}")[:data]
       end
 
-      def list(audience_id: nil, page: nil, limit: nil)
+      def list(audience_id: nil, page: nil, limit: nil, sort_by: nil, sort_dir: nil, subscribed_only: nil)
         params = {}
-        params[:audience_id] = audience_id if audience_id
+        params[:audienceId] = audience_id if audience_id
         params[:page] = page if page
         params[:limit] = limit if limit
+        params[:sortBy] = sort_by if sort_by
+        params[:sortDir] = sort_dir if sort_dir
+        params[:subscribedOnly] = subscribed_only.to_s if !subscribed_only.nil?
 
         query = @client.send(:build_query_string, params)
         @client.request('GET', "/api/v1/public/contacts/get-contacts#{query}")[:data]
       end
 
-      def update(email, **params)
-        @client.request('PATCH', "/api/v1/public/contacts/update-contact?email=#{URI.encode_www_form_component(email)}", body: params.compact)[:data]
+      def update(id_or_email, **params)
+        if id_or_email.include?('@')
+          warn '[Keplars] Deprecated: passing email to update() is deprecated since v2.7.0. Use contact ID instead.'
+          param = 'email'
+        else
+          param = 'id'
+        end
+        @client.request('PATCH', "/api/v1/public/contacts/update-contact?#{param}=#{URI.encode_www_form_component(id_or_email)}", body: params.compact)[:data]
       end
 
-      def delete(email)
-        @client.request('DELETE', "/api/v1/public/contacts/delete-contact?email=#{URI.encode_www_form_component(email)}")[:data]
+      def delete(id_or_email)
+        if id_or_email.include?('@')
+          warn '[Keplars] Deprecated: passing email to delete() is deprecated since v2.7.0. Use contact ID instead.'
+          param = 'email'
+        else
+          param = 'id'
+        end
+        @client.request('DELETE', "/api/v1/public/contacts/delete-contact?#{param}=#{URI.encode_www_form_component(id_or_email)}")[:data]
       end
     end
   end

data/lib/keplars/domains.rb

@@ -1,8 +1,10 @@
 module Keplars
   module Resources
     class Domains < Base
-      def add(domain)
-        @client.request('POST', '/api/v1/public/domains/add-domain', body: { domain: domain })[:data]
+      def add(domain, region: nil)
+        body = { domain: domain }
+        body[:region] = region if region
+        @client.request('POST', '/api/v1/public/domains/add-domain', body: body)[:data]
       end
 
       def list
@@ -22,7 +24,12 @@ module Keplars
       end
 
       def create_api_key(**params)
-        @client.request('POST', '/api/v1/public/domains/api-keys/create', body: params.compact)[:data]
+        body = params.dup
+        if body.key?(:domain_id) && !body.key?(:custom_domain_id)
+          warn '[Keplars] Deprecated: :domain_id is deprecated since v2.7.0. Use :custom_domain_id instead.'
+          body[:custom_domain_id] = body.delete(:domain_id)
+        end
+        @client.request('POST', '/api/v1/public/domains/api-keys/create', body: body.compact)[:data]
       end
     end
   end

data/lib/keplars/resources.rb

@@ -8,22 +8,22 @@ module Keplars
 
     class Emails < Base
       def send_instant(**args)
-        body = args.compact
+        body = normalize_email_args(args)
         @client.request('POST', '/api/v1/send-email/instant', body: body)[:data]
       end
 
       def send_high(**args)
-        body = args.compact
+        body = normalize_email_args(args)
         @client.request('POST', '/api/v1/send-email/high', body: body)[:data]
       end
 
       def send_async(**args)
-        body = args.compact
+        body = normalize_email_args(args)
         @client.request('POST', '/api/v1/send-email/async', body: body)[:data]
       end
 
       def send_bulk(**args)
-        body = args.compact
+        body = normalize_email_args(args)
         @client.request('POST', '/api/v1/send-email/bulk', body: body)[:data]
       end
 
@@ -32,9 +32,56 @@ module Keplars
       end
 
       def schedule(**args)
-        body = args.compact
-        body[:priority] ||= 'async'
-        @client.request('POST', '/api/v1/send-email/schedule', body: body)[:data]
+        body = args.dup
+
+        if body.key?(:scheduled_for) && !body.key?(:scheduled_at)
+          warn '[Keplars] Deprecated: :scheduled_for is deprecated since v2.7.0. Use :scheduled_at instead.'
+          body[:scheduled_at] = body.delete(:scheduled_for)
+        end
+
+        scheduled_at = body.delete(:scheduled_at)
+        timezone = body.delete(:timezone)
+        body.delete(:priority)
+
+        raise ArgumentError, 'scheduled_at is required for scheduling emails' unless scheduled_at
+
+        email_body = normalize_email_args(body).compact
+
+        payload = { scheduled_at: scheduled_at, email: email_body }
+        payload[:timezone] = timezone if timezone
+
+        @client.request('POST', '/api/v1/send-email/schedule', body: payload)[:data]
+      end
+
+      private
+
+      def normalize_email_args(args)
+        body = args.dup
+
+        if body.key?(:to) && !body[:to].is_a?(Array)
+          raise ArgumentError, 'to must be an array of email addresses, e.g. to: ["user@example.com"]'
+        end
+
+        if body.key?(:html)
+          warn '[Keplars] Deprecated: :html is deprecated since v2.7.0. Use :body + is_html: true instead.'
+          body[:body] ||= body.delete(:html)
+          body[:is_html] = true unless body.key?(:is_html)
+          body.delete(:html)
+        end
+
+        if body.key?(:text)
+          warn '[Keplars] Deprecated: :text is deprecated since v2.7.0. Use :body instead.'
+          body[:body] ||= body.delete(:text)
+          body.delete(:text)
+        end
+
+        if body.key?(:template_data)
+          warn '[Keplars] Deprecated: :template_data is deprecated since v2.7.0. Use :params instead.'
+          body[:params] ||= body.delete(:template_data)
+          body.delete(:template_data)
+        end
+
+        body.compact
       end
     end
   end

data/lib/keplars/version.rb

@@ -1,3 +1,3 @@
 module Keplars
-  VERSION = "2.1.0"
+  VERSION = "2.8.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: keplars
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.8.0
 platform: ruby
 authors:
 - Keplars
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-20 00:00:00.000000000 Z
+date: 2026-08-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday