bas 1.7.2 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87acac8ff5c199705abe5b3e41d72834bf104298aa2533740dd40a637f7d7ca2
-  data.tar.gz: d8bc727403b7eaaf2211116fb0e697a0c7b709022b43528ac1d4afffb25c7167
+  metadata.gz: a27720481a463c1a4a6edaeda8d9c159d009a11546802f559fd4232be721a146
+  data.tar.gz: fb829e6b146c295403118870324641d6e8e57ca3231259493aa686c4045d2b80
 SHA512:
-  metadata.gz: e2fa969db931a22fa52e973ff7438e68f3cace2a25dd625394230c13b2939f0aa0190f3068ce69a16346bc9d7cc53aa52c7fde54f9cf76c97801f37f9c4b20c3
-  data.tar.gz: bd4443f7a5ce9c638936cbb73062148bf77c7fe1721eba3470f602d6cfcbb5b7d0c6dca815e3e79425875a921224cfc0fee5ebf16922fe50426524273d354195
+  metadata.gz: 8a76d3b14aaf04f243a26968e79726025156d491f47ecde2435b5f83c316d3275a61f5cda1de54105459e0d420678c5379194d59f7c7e3d21c8208c10305c730
+  data.tar.gz: 34d41b30c0b3520edd259d325973b6b6a87467f7aac874ee17b630a292b68c57155c40157748a8a5c37c593e93be68dd9cee94136b55155d30324a6744a3d2db

data/CHANGELOG.md

@@ -1,5 +1,8 @@
 # Changelog
 
+# 1.8.0 (07.07.2025)
+- [Feat: Implement client to interact with Operaton's API-REST](https://github.com/kommitters/bas/pull/142)
+
 # 1.7.2 (04.07.2025)
 - [Improve Elasticsearch mapping creation](https://github.com/kommitters/bas/pull/140)
 - [Fix in Elasticsearch shared storage update_stage method](https://github.com/kommitters/bas/pull/139)

data/Gemfile

@@ -15,6 +15,10 @@ gem "simplecov-lcov", "~> 0.8.0"
 gem "vcr"
 gem "webmock"
 
+gem "faraday", "~> 2.9"
+
+gem "json", "~> 2.8"
+
 gem "elasticsearch", "~> 8.0"
 gem "httparty"
 gem "pg", "~> 1.5", ">= 1.5.4"

data/lib/bas/utils/operaton/external_task_client.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+require "faraday"
+require "json"
+
+module Bas
+  module Utils
+    module Operaton
+      # Client for interacting with Operaton's External Task API
+      #
+      # This client provides methods to manage external task lifecycle including:
+      # - Fetching and locking tasks
+      # - Completing tasks with variables
+      # - Unlocking tasks
+      # - Reporting task failures
+      #
+      # @example
+      #   client = ExternalTaskClient.new(base_url: "https://api.operaton.com", worker_id: "worker-123")
+      #   tasks = client.fetch_and_lock("my-topic")
+      class ExternalTaskClient
+        def initialize(base_url:, worker_id:)
+          raise ArgumentError, "base_url cannot be nil or empty" if base_url.nil? || base_url.empty?
+          raise ArgumentError, "worker_id cannot be nil or empty" if worker_id.nil? || worker_id.empty?
+
+          @base_url = base_url
+          @worker_id = worker_id
+
+          @conn = Faraday.new(url: base_url) do |f|
+            f.request :json
+            f.response :json, content_type: /\bjson$/
+            f.adapter Faraday.default_adapter
+          end
+        end
+
+        def fetch_and_lock(topics_str, lock_duration: 10_000, max_tasks: 1, use_priority: true, variables: [])
+          post("/external-task/fetchAndLock",
+               workerId: @worker_id,
+               maxTasks: max_tasks,
+               usePriority: use_priority,
+               topics: build_topics_payload(topics_str, lock_duration, variables))
+        end
+
+        def complete(task_id, variables = {})
+          post("/external-task/#{task_id}/complete", workerId: @worker_id,
+                                                     variables: format_variables(variables))
+        end
+
+        def get_variables(task_id)
+          get("/external-task/#{task_id}/variables")
+        end
+
+        def unlock(task_id)
+          post("/external-task/#{task_id}/unlock")
+        end
+
+        def report_failure(task_id, error_message:, error_details:, retries:, retry_timeout:)
+          post("/external-task/#{task_id}/failure",
+               workerId: @worker_id,
+               errorMessage: error_message,
+               errorDetails: error_details,
+               retries: retries,
+               retryTimeout: retry_timeout)
+        end
+
+        private
+
+        def build_topics_payload(topics_str, lock_duration, variables)
+          topic_names = topics_str.is_a?(Array) ? topics_str : topics_str.to_s.split(",")
+          topic_names.map do |name|
+            {
+              topicName: name.strip,
+              lockDuration: lock_duration,
+              variables: variables
+            }
+          end
+        end
+
+        def full_url(path)
+          "#{@base_url}#{path}"
+        end
+
+        def post(path, body = {})
+          handle_response(@conn.post(full_url(path), body))
+        end
+
+        def get(path, params = {})
+          handle_response(@conn.get(full_url(path), params))
+        end
+
+        def handle_response(response)
+          raise "Operaton API Error #{response.status}: #{response.body}" unless response.success?
+
+          response.body
+        end
+
+        def format_variables(vars)
+          vars.transform_values do |value|
+            {
+              value: value,
+              type: ruby_type_to_operaton_type(value)
+            }
+          end
+        end
+
+        def ruby_type_to_operaton_type(value)
+          case value
+          when String then "String"
+          when Integer then "Integer"
+          when Float then "Double"
+          when TrueClass, FalseClass then "Boolean"
+          else "Object"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/bas/version.rb

@@ -2,5 +2,5 @@
 
 module Bas
   # Gem version
-  VERSION = "1.7.2"
+  VERSION = "1.8.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bas
 version: !ruby/object:Gem::Version
-  version: 1.7.2
+  version: 1.8.0
 platform: ruby
 authors:
 - kommitters Open Source
@@ -98,6 +98,7 @@ files:
 - lib/bas/utils/notion/update_db_page.rb
 - lib/bas/utils/notion/update_db_state.rb
 - lib/bas/utils/openai/run_assistant.rb
+- lib/bas/utils/operaton/external_task_client.rb
 - lib/bas/utils/postgres/request.rb
 - lib/bas/version.rb
 - renovate.json