bas 1.7.2 → 1.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87acac8ff5c199705abe5b3e41d72834bf104298aa2533740dd40a637f7d7ca2
-  data.tar.gz: d8bc727403b7eaaf2211116fb0e697a0c7b709022b43528ac1d4afffb25c7167
+  metadata.gz: 83923ab43148fb334e5809f95b2c4387b6bffccb36a7b034f9f6067ad9a75783
+  data.tar.gz: 6d78bf8adf6e1644c85fc77c6ff3b60f21953fac861aa1dfc99210422dc84dba
 SHA512:
-  metadata.gz: e2fa969db931a22fa52e973ff7438e68f3cace2a25dd625394230c13b2939f0aa0190f3068ce69a16346bc9d7cc53aa52c7fde54f9cf76c97801f37f9c4b20c3
-  data.tar.gz: bd4443f7a5ce9c638936cbb73062148bf77c7fe1721eba3470f602d6cfcbb5b7d0c6dca815e3e79425875a921224cfc0fee5ebf16922fe50426524273d354195
+  metadata.gz: 792b8feddf38fd47f80d1b3443e4a019e2e0fdae196aa02fe6c5949492ffc586abec3a64ba4fcedd0cd53994da2bdaff81008a0d9ffe0c356e7d68650f83b84f
+  data.tar.gz: 73b45576f90b0d47448d78fec58f80ceca36304aa1b52e9c72813c7f102a0cdee71b80d0e1528e8d7f135af618ab2732d48e6e833746b7a46d2824d7a75a8265

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+# 1.8.1 (08.07.2025)
+- [refactor: Refactor client for correct use of shared_storage](https://github.com/kommitters/bas/pull/144)
+
+# 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,131 @@
+# frozen_string_literal: true
+
+require "faraday"
+require "json"
+
+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 = Utils::Operaton::ExternalTaskClient.execute(base_url: "https://api.operaton.com",
+    #                                                        worker_id: "worker-123")
+    #   tasks = client.fetch_and_lock("my-topic")
+    class ExternalTaskClient
+      def self.execute(params)
+        new(params)
+      end
+
+      def initialize(params)
+        validate_params!(params)
+
+        @base_url = params[:base_url]
+        @worker_id = params[: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 validate_params!(params)
+        raise ArgumentError, "base_url cannot be nil or empty" if params[:base_url].to_s.strip.empty?
+        raise ArgumentError, "worker_id cannot be nil or empty" if params[:worker_id].to_s.strip.empty?
+      end
+
+      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

data/lib/bas/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bas
 version: !ruby/object:Gem::Version
-  version: 1.7.2
+  version: 1.8.1
 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