loops_sdk 2.2.0 → 2.4.0

data/lib/loops_sdk/audience_segments.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module LoopsSdk
+  class AudienceSegments < Base
+    class << self
+      def list(perPage: 20, cursor: nil)
+        make_request(method: :get, path: "v1/audience-segments", params: { perPage: perPage, cursor: cursor })
+      end
+
+      def get(audience_segment_id:)
+        make_request(method: :get, path: "v1/audience-segments/#{audience_segment_id}")
+      end
+
+      def create(name:, filter:, description: nil)
+        body = { name: name, filter: filter, description: description }.compact
+        make_request(method: :post, path: "v1/audience-segments", body: body)
+      end
+    end
+  end
+end

data/lib/loops_sdk/base.rb

@@ -13,7 +13,7 @@ module LoopsSdk
           limit = response.headers["x-ratelimit-limit"]
           remaining = response.headers["x-ratelimit-remaining"]
           raise RateLimitError.new(limit, remaining)
-        when 400, 401, 404, 405, 409, 413, 422, 500
+        when 400, 401, 404, 405, 409, 413, 422, 500, 501
           raise APIError.new(response.status, response.body)
         else
           raise APIError.new(response.status, "Unexpected error occurred")

data/lib/loops_sdk/campaign_groups.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module LoopsSdk
+  class CampaignGroups < Base
+    class << self
+      def list(perPage: 20, cursor: nil)
+        make_request(method: :get, path: "v1/campaign-groups", params: { perPage: perPage, cursor: cursor })
+      end
+
+      def create(name:, description: nil)
+        body = { name: name, description: description }.compact
+        make_request(method: :post, path: "v1/campaign-groups", body: body)
+      end
+
+      def get(campaign_group_id:)
+        make_request(method: :get, path: "v1/campaign-groups/#{campaign_group_id}")
+      end
+
+      def update(campaign_group_id:, name: nil, description: nil)
+        body = { name: name, description: description }.compact
+        make_request(method: :post, path: "v1/campaign-groups/#{campaign_group_id}", body: body)
+      end
+    end
+  end
+end

data/lib/loops_sdk/campaigns.rb

@@ -7,16 +7,32 @@ module LoopsSdk
         make_request(method: :get, path: "v1/campaigns", params: { perPage: perPage, cursor: cursor })
       end
 
-      def create(name:)
-        make_request(method: :post, path: "v1/campaigns", body: { name: name })
+      def create(name:, campaign_group_id: nil, mailing_list_id: nil, audience_segment_id: nil, audience_filter: nil, scheduling: nil)
+        body = {
+          name: name,
+          campaignGroupId: campaign_group_id,
+          mailingListId: mailing_list_id,
+          audienceSegmentId: audience_segment_id,
+          audienceFilter: audience_filter,
+          scheduling: scheduling
+        }.compact
+        make_request(method: :post, path: "v1/campaigns", body: body)
       end
 
       def get(campaign_id:)
         make_request(method: :get, path: "v1/campaigns/#{campaign_id}")
       end
 
-      def update(campaign_id:, name:)
-        make_request(method: :post, path: "v1/campaigns/#{campaign_id}", body: { name: name })
+      def update(campaign_id:, name: nil, campaign_group_id: nil, mailing_list_id: nil, audience_segment_id: nil, audience_filter: nil, scheduling: nil)
+        body = {
+          name: name,
+          campaignGroupId: campaign_group_id,
+          mailingListId: mailing_list_id,
+          audienceSegmentId: audience_segment_id,
+          audienceFilter: audience_filter,
+          scheduling: scheduling
+        }.compact
+        make_request(method: :post, path: "v1/campaigns/#{campaign_id}", body: body)
       end
     end
   end

data/lib/loops_sdk/components.rb

@@ -10,6 +10,15 @@ module LoopsSdk
       def get(component_id:)
         make_request(method: :get, path: "v1/components/#{component_id}")
       end
+
+      def create(name:, lmx:)
+        make_request(method: :post, path: "v1/components", body: { name: name, lmx: lmx })
+      end
+
+      def update(component_id:, name: nil, lmx: nil)
+        body = { name: name, lmx: lmx }.compact
+        make_request(method: :post, path: "v1/components/#{component_id}", body: body)
+      end
     end
   end
 end

data/lib/loops_sdk/email_messages.rb

@@ -7,7 +7,23 @@ module LoopsSdk
         make_request(method: :get, path: "v1/email-messages/#{email_message_id}")
       end
 
-      def update(email_message_id:, expected_revision_id: nil, subject: nil, preview_text: nil, from_name: nil, from_email: nil, reply_to_email: nil, lmx: nil)
+      def update(
+        email_message_id:,
+        expected_revision_id: nil,
+        subject: nil,
+        preview_text: nil,
+        from_name: nil,
+        from_email: nil,
+        reply_to_email: nil,
+        cc_email: nil,
+        bcc_email: nil,
+        language_code: nil,
+        email_format: nil,
+        lmx: nil,
+        contact_properties_fallbacks: nil,
+        event_properties_fallbacks: nil,
+        data_variables_fallbacks: nil
+      )
         body = {
           expectedRevisionId: expected_revision_id,
           subject: subject,
@@ -15,10 +31,32 @@ module LoopsSdk
           fromName: from_name,
           fromEmail: from_email,
           replyToEmail: reply_to_email,
-          lmx: lmx
+          ccEmail: cc_email,
+          bccEmail: bcc_email,
+          languageCode: language_code,
+          emailFormat: email_format,
+          lmx: lmx,
+          contactPropertiesFallbacks: contact_properties_fallbacks,
+          eventPropertiesFallbacks: event_properties_fallbacks,
+          dataVariablesFallbacks: data_variables_fallbacks
         }.compact
         make_request(method: :post, path: "v1/email-messages/#{email_message_id}", body: body)
       end
+
+      def preview(email_message_id:, emails:, contact_properties: nil, event_properties: nil, data_variables: nil)
+        body = {
+          emails: emails,
+          contactProperties: contact_properties,
+          eventProperties: event_properties,
+          dataVariables: data_variables
+        }.compact
+        make_request(method: :post, path: "v1/email-messages/#{email_message_id}/preview", body: body)
+      end
+
+      def run_guardian(email_message_id:)
+        make_request(method: :get, path: "v1/email-messages/#{email_message_id}/guardian")
+      end
     end
   end
 end
+

data/lib/loops_sdk/event_patterns.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require "cgi"
+
+module LoopsSdk
+  class EventPatterns < Base
+    class << self
+      def list(perPage: 20, cursor: nil)
+        make_request(method: :get, path: "v1/event-patterns", params: { perPage: perPage, cursor: cursor })
+      end
+
+      def get(event_pattern_id:)
+        make_request(method: :get, path: "v1/event-patterns/#{event_pattern_id}")
+      end
+
+      def get_by_name(event_name:)
+        encoded_name = CGI.escapeURIComponent(event_name)
+        make_request(method: :get, path: "v1/event-patterns/by-name/#{encoded_name}")
+      end
+    end
+  end
+end

data/lib/loops_sdk/themes.rb

@@ -10,6 +10,16 @@ module LoopsSdk
       def get(theme_id:)
         make_request(method: :get, path: "v1/themes/#{theme_id}")
       end
+
+      def create(name:, styles: nil)
+        body = { name: name, styles: styles }.compact
+        make_request(method: :post, path: "v1/themes", body: body)
+      end
+
+      def update(theme_id:, name: nil, styles: nil)
+        body = { name: name, styles: styles }.compact
+        make_request(method: :post, path: "v1/themes/#{theme_id}", body: body)
+      end
     end
   end
 end

data/lib/loops_sdk/transactional.rb

@@ -4,8 +4,31 @@ module LoopsSdk
   class Transactional < Base
     class << self
       def list(perPage: 20, cursor: nil)
-        make_request(method: :get, path: "v1/transactional", params: { perPage: perPage, cursor: cursor })
+        make_request(method: :get, path: "v1/transactional-emails", params: { perPage: perPage, cursor: cursor })
       end
+
+      def create(name:, transactional_group_id: nil)
+        body = { name: name, transactionalGroupId: transactional_group_id }.compact
+        make_request(method: :post, path: "v1/transactional-emails", body: body)
+      end
+
+      def get(transactional_id:)
+        make_request(method: :get, path: "v1/transactional-emails/#{transactional_id}")
+      end
+
+      def update(transactional_id:, name: nil, transactional_group_id: nil)
+        body = { name: name, transactionalGroupId: transactional_group_id }.compact
+        make_request(method: :post, path: "v1/transactional-emails/#{transactional_id}", body: body)
+      end
+
+      def ensure_draft(transactional_id:)
+        make_request(method: :post, path: "v1/transactional-emails/#{transactional_id}/draft")
+      end
+
+      def publish(transactional_id:)
+        make_request(method: :post, path: "v1/transactional-emails/#{transactional_id}/publish")
+      end
+
       def send(transactional_id:, email:, add_to_audience: false, data_variables: {}, attachments: [], headers: {})
         attachments = attachments.map do |attachment|
           attachment.transform_keys { |key| key == :content_type ? :contentType : key }

data/lib/loops_sdk/transactional_groups.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module LoopsSdk
+  class TransactionalGroups < Base
+    class << self
+      def list(perPage: 20, cursor: nil)
+        make_request(method: :get, path: "v1/transactional-groups", params: { perPage: perPage, cursor: cursor })
+      end
+
+      def create(name:, description: nil)
+        body = { name: name, description: description }.compact
+        make_request(method: :post, path: "v1/transactional-groups", body: body)
+      end
+
+      def get(transactional_group_id:)
+        make_request(method: :get, path: "v1/transactional-groups/#{transactional_group_id}")
+      end
+
+      def update(transactional_group_id:, name: nil, description: nil)
+        body = { name: name, description: description }.compact
+        make_request(method: :post, path: "v1/transactional-groups/#{transactional_group_id}", body: body)
+      end
+    end
+  end
+end

data/lib/loops_sdk/uploads.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module LoopsSdk
+  class Uploads < Base
+    SUPPORTED_CONTENT_TYPES = %w[image/jpeg image/png image/gif image/webp].freeze
+
+    class << self
+      def upload(path:, content_type: nil)
+        data = File.binread(path)
+        content_type ||= detect_content_type(data)
+        validate_content_type!(content_type)
+
+        create_response = make_request(
+          method: :post,
+          path: "v1/uploads",
+          body: { contentType: content_type, contentLength: data.bytesize }
+        )
+
+        put_to_presigned_url(create_response["presignedUrl"], data, content_type)
+
+        make_request(
+          method: :post,
+          path: "v1/uploads/#{create_response["emailAssetId"]}/complete"
+        )
+      end
+
+      private
+
+      def detect_content_type(data)
+        if data.start_with?("\xFF\xD8\xFF".b)
+          "image/jpeg"
+        elsif data.start_with?("\x89PNG\r\n\x1a\n".b)
+          "image/png"
+        elsif data.start_with?("GIF87a".b, "GIF89a".b)
+          "image/gif"
+        elsif data.bytesize >= 12 && data[0, 4] == "RIFF".b && data[8, 4] == "WEBP".b
+          "image/webp"
+        else
+          raise ArgumentError,
+                "Unable to detect image type. Pass content_type: explicitly. " \
+                "Supported types: #{SUPPORTED_CONTENT_TYPES.join(', ')}."
+        end
+      end
+
+      def validate_content_type!(content_type)
+        return if SUPPORTED_CONTENT_TYPES.include?(content_type)
+
+        raise ArgumentError,
+              "Unsupported content_type: #{content_type}. " \
+              "Supported types: #{SUPPORTED_CONTENT_TYPES.join(', ')}."
+      end
+
+      def put_to_presigned_url(url, data, content_type)
+        response = Faraday.put(url) do |req|
+          req.headers["Content-Type"] = content_type
+          req.headers["Content-Length"] = data.bytesize.to_s
+          req.body = data
+        end
+
+        return if response.success?
+
+        raise APIError.new(response.status, response.body)
+      end
+    end
+  end
+end

data/lib/loops_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LoopsSdk
-  VERSION = "2.2.0"
+  VERSION = "2.4.0"
 end

data/lib/loops_sdk/workflows.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+module LoopsSdk
+  class Workflows < Base
+    class << self
+      def list(perPage: 20, cursor: nil)
+        make_request(method: :get, path: "v1/workflows", params: { perPage: perPage, cursor: cursor })
+      end
+
+      def create(name:, description: nil, mailing_list_id: nil)
+        body = {
+          name: name,
+          description: description,
+          mailingListId: mailing_list_id
+        }.compact
+        make_request(method: :post, path: "v1/workflows", body: body)
+      end
+
+      def get(workflow_id:)
+        make_request(method: :get, path: "v1/workflows/#{workflow_id}")
+      end
+
+      def update(workflow_id:, expected_revision_id:, name: nil, description: nil)
+        body = {
+          expectedRevisionId: expected_revision_id,
+          name: name,
+          description: description
+        }.compact
+        # expectedRevisionId may be null for older workflows; always include it
+        body[:expectedRevisionId] = expected_revision_id
+        make_request(method: :post, path: "v1/workflows/#{workflow_id}", body: body)
+      end
+
+      def change_mailing_list(workflow_id:, expected_revision_id:, mailing_list_id:, dry_run: nil, queued_contact_policy: nil)
+        body = {
+          expectedRevisionId: expected_revision_id,
+          mailingListId: mailing_list_id,
+          dryRun: dry_run,
+          queuedContactPolicy: queued_contact_policy
+        }.compact
+        # expectedRevisionId and mailingListId may be null; always include them
+        body[:expectedRevisionId] = expected_revision_id
+        body[:mailingListId] = mailing_list_id
+        make_request(method: :post, path: "v1/workflows/#{workflow_id}/mailing-list", body: body)
+      end
+
+      def get_node(workflow_id:, node_id:)
+        make_request(method: :get, path: "v1/workflows/#{workflow_id}/nodes/#{node_id}")
+      end
+
+      def create_node(
+        workflow_id:,
+        expected_revision_id:,
+        insert_mode:,
+        node_type_name:,
+        from_node_id: nil,
+        to_node_id: nil,
+        before_node_id: nil
+      )
+        body = {
+          expectedRevisionId: expected_revision_id,
+          insertMode: insert_mode,
+          nodeTypeName: node_type_name,
+          fromNodeId: from_node_id,
+          toNodeId: to_node_id,
+          beforeNodeId: before_node_id
+        }.compact
+        body[:expectedRevisionId] = expected_revision_id
+        make_request(method: :post, path: "v1/workflows/#{workflow_id}/nodes", body: body)
+      end
+
+      def update_node(workflow_id:, node_id:, expected_revision_id:, payload:)
+        body = {
+          expectedRevisionId: expected_revision_id,
+          payload: payload
+        }
+        make_request(method: :post, path: "v1/workflows/#{workflow_id}/nodes/#{node_id}", body: body)
+      end
+
+      def delete_node(workflow_id:, node_id:, expected_revision_id:, dry_run: nil, queued_contact_policy: nil)
+        body = {
+          expectedRevisionId: expected_revision_id,
+          dryRun: dry_run,
+          queuedContactPolicy: queued_contact_policy
+        }.compact
+        body[:expectedRevisionId] = expected_revision_id
+        make_request(method: :delete, path: "v1/workflows/#{workflow_id}/nodes/#{node_id}", body: body)
+      end
+
+      def add_branch(workflow_id:, node_id:, expected_revision_id:)
+        body = { expectedRevisionId: expected_revision_id }
+        make_request(method: :post, path: "v1/workflows/#{workflow_id}/nodes/#{node_id}/add-branch", body: body)
+      end
+
+      def delete_node_recursive(workflow_id:, node_id:, expected_revision_id:, dry_run: nil, queued_contact_policy: nil)
+        body = {
+          expectedRevisionId: expected_revision_id,
+          dryRun: dry_run,
+          queuedContactPolicy: queued_contact_policy
+        }.compact
+        body[:expectedRevisionId] = expected_revision_id
+        make_request(method: :delete, path: "v1/workflows/#{workflow_id}/nodes/#{node_id}/recursive", body: body)
+      end
+    end
+  end
+end

data/lib/loops_sdk.rb

@@ -15,7 +15,13 @@ require_relative "loops_sdk/dedicated_sending_ips"
 require_relative "loops_sdk/themes"
 require_relative "loops_sdk/components"
 require_relative "loops_sdk/campaigns"
+require_relative "loops_sdk/campaign_groups"
 require_relative "loops_sdk/email_messages"
+require_relative "loops_sdk/uploads"
+require_relative "loops_sdk/audience_segments"
+require_relative "loops_sdk/workflows"
+require_relative "loops_sdk/event_patterns"
+require_relative "loops_sdk/transactional_groups"
 
 module LoopsSdk
   class << self

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: loops_sdk
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 2.4.0
 platform: ruby
 authors:
 - Dan Rowden
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-21 00:00:00.000000000 Z
+date: 2026-08-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -35,7 +35,9 @@ files:
 - README.md
 - lib/loops_sdk.rb
 - lib/loops_sdk/api_key.rb
+- lib/loops_sdk/audience_segments.rb
 - lib/loops_sdk/base.rb
+- lib/loops_sdk/campaign_groups.rb
 - lib/loops_sdk/campaigns.rb
 - lib/loops_sdk/components.rb
 - lib/loops_sdk/configuration.rb
@@ -43,11 +45,15 @@ files:
 - lib/loops_sdk/contacts.rb
 - lib/loops_sdk/dedicated_sending_ips.rb
 - lib/loops_sdk/email_messages.rb
+- lib/loops_sdk/event_patterns.rb
 - lib/loops_sdk/events.rb
 - lib/loops_sdk/mailing_lists.rb
 - lib/loops_sdk/themes.rb
 - lib/loops_sdk/transactional.rb
+- lib/loops_sdk/transactional_groups.rb
+- lib/loops_sdk/uploads.rb
 - lib/loops_sdk/version.rb
+- lib/loops_sdk/workflows.rb
 homepage: https://loops.so/docs/api-reference
 licenses:
 - MIT