loops_sdk 2.3.0 → 2.6.0

data/lib/loops_sdk/audience_segments.rb

@@ -10,6 +10,11 @@ module LoopsSdk
       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

@@ -9,11 +9,13 @@ module LoopsSdk
         case response.status
         when 200, 201
           JSON.parse(response.body)
+        when 204
+          nil
         when 429
           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/campaigns.rb

@@ -34,6 +34,10 @@ module LoopsSdk
         }.compact
         make_request(method: :post, path: "v1/campaigns/#{campaign_id}", body: body)
       end
+
+      def metrics(campaign_id:)
+        make_request(method: :get, path: "v1/campaigns/#{campaign_id}/metrics")
+      end
     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

@@ -52,6 +52,11 @@ module LoopsSdk
         }.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

@@ -29,6 +29,10 @@ module LoopsSdk
         make_request(method: :post, path: "v1/transactional-emails/#{transactional_id}/publish")
       end
 
+      def metrics(transactional_id:)
+        make_request(method: :get, path: "v1/transactional-emails/#{transactional_id}/metrics")
+      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/version.rb

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

data/lib/loops_sdk/workflow_groups.rb

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

data/lib/loops_sdk/workflows.rb

@@ -7,13 +7,148 @@ module LoopsSdk
         make_request(method: :get, path: "v1/workflows", params: { perPage: perPage, cursor: cursor })
       end
 
+      def create(name:, description: nil, mailing_list_id: nil, workflow_group_id: nil)
+        body = {
+          name: name,
+          description: description,
+          mailingListId: mailing_list_id,
+          workflowGroupId: workflow_group_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, workflow_group_id: nil)
+        body = {
+          expectedRevisionId: expected_revision_id,
+          name: name,
+          description: description,
+          workflowGroupId: workflow_group_id
+        }.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 delete(workflow_id:, expected_revision_id:, confirm_delete: nil)
+        body = {
+          expectedRevisionId: expected_revision_id,
+          confirmDelete: confirm_delete
+        }.compact
+        # expectedRevisionId may be null for older workflows; always include it
+        body[:expectedRevisionId] = expected_revision_id
+        make_request(method: :delete, 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 get_node_metrics(workflow_id:, node_id:)
+        make_request(method: :get, path: "v1/workflows/#{workflow_id}/nodes/#{node_id}/metrics")
+      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
+        }
+
+        case insert_mode
+        when "between"
+          raise ArgumentError, "from_node_id and to_node_id are required when insert_mode is \"between\"." if from_node_id.nil? || to_node_id.nil?
+          raise ArgumentError, "before_node_id is not permitted when insert_mode is \"between\"." unless before_node_id.nil?
+
+          body[:fromNodeId] = from_node_id
+          body[:toNodeId] = to_node_id
+        when "before"
+          raise ArgumentError, "from_node_id is not permitted when insert_mode is \"before\"." unless from_node_id.nil?
+          raise ArgumentError, "Provide either to_node_id or before_node_id when insert_mode is \"before\", not both." if !to_node_id.nil? && !before_node_id.nil?
+          raise ArgumentError, "to_node_id or before_node_id is required when insert_mode is \"before\"." if to_node_id.nil? && before_node_id.nil?
+
+          if !to_node_id.nil?
+            body[:toNodeId] = to_node_id
+          else
+            body[:beforeNodeId] = before_node_id
+          end
+        when "after"
+          raise ArgumentError, "from_node_id is required when insert_mode is \"after\"." if from_node_id.nil?
+          raise ArgumentError, "to_node_id is not permitted when insert_mode is \"after\"." unless to_node_id.nil?
+          raise ArgumentError, "before_node_id is not permitted when insert_mode is \"after\"." unless before_node_id.nil?
+
+          body[:fromNodeId] = from_node_id
+        else
+          raise ArgumentError, "insert_mode must be \"between\", \"before\", or \"after\"."
+        end
+
+        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 reroute_node(workflow_id:, node_id:, expected_revision_id:, new_target_node_id:)
+        body = {
+          expectedRevisionId: expected_revision_id,
+          newTargetNodeId: new_target_node_id
+        }
+        make_request(method: :post, path: "v1/workflows/#{workflow_id}/nodes/#{node_id}/reroute", 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

@@ -20,6 +20,8 @@ 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/workflow_groups"
+require_relative "loops_sdk/event_patterns"
 require_relative "loops_sdk/transactional_groups"
 
 module LoopsSdk

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: loops_sdk
 version: !ruby/object:Gem::Version
-  version: 2.3.0
+  version: 2.6.0
 platform: ruby
 authors:
 - Dan Rowden
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-24 00:00:00.000000000 Z
+date: 2026-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -45,6 +45,7 @@ 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
@@ -52,6 +53,7 @@ files:
 - lib/loops_sdk/transactional_groups.rb
 - lib/loops_sdk/uploads.rb
 - lib/loops_sdk/version.rb
+- lib/loops_sdk/workflow_groups.rb
 - lib/loops_sdk/workflows.rb
 homepage: https://loops.so/docs/api-reference
 licenses: