busybee 0.1.0 → 0.3.0

data/lib/busybee.rb

@@ -1,7 +1,139 @@
 # frozen_string_literal: true
 
-require_relative "busybee/version"
+require "socket"
+require "busybee/version"
+require "busybee/defaults"
+require "busybee/configure"
+require "busybee/credentials"
+require "busybee/logging"
+require "busybee/serialization"
+require "busybee/job"
+require "busybee/job_stream"
+require "busybee/client"
+require "busybee/worker"
+require "busybee/runtime_config"
+require "busybee/runner"
+require "busybee/cli"
 
-# Top-level gem module, only holds configuration values.
+# Top-level gem module. Configuration readers and defaults live here;
+# validated setters live in Busybee::Configure.
 module Busybee
+  # Valid credential type identifiers. Update this as new credential classes are added.
+  VALID_CREDENTIAL_TYPES = %w[insecure tls oauth camunda_cloud].freeze
+
+  # Valid log format identifiers.
+  VALID_LOG_FORMATS = %w[text json].freeze
+
+  # Valid worker mode identifiers.
+  VALID_WORKER_MODES = %i[polling streaming hybrid].freeze
+
+  class << self
+    include Configure
+
+    attr_accessor :logger
+    attr_reader :credentials
+
+    def configure
+      yield self
+    end
+
+    def cluster_address
+      @cluster_address || ENV.fetch("CLUSTER_ADDRESS", "localhost:26500")
+    end
+
+    def credential_type
+      return @credential_type if instance_variable_defined?(:@credential_type) && !@credential_type.nil?
+
+      # Env var fallback - goes through setter for validation
+      env_value = ENV.fetch("BUSYBEE_CREDENTIAL_TYPE", nil)
+      return nil if env_value.nil?
+
+      self.credential_type = env_value
+      @credential_type
+    end
+
+    def default_fail_job_backoff
+      @default_fail_job_backoff || Defaults::DEFAULT_FAIL_JOB_BACKOFF_MS
+    end
+
+    def default_max_jobs
+      @default_max_jobs || Defaults::DEFAULT_MAX_JOBS
+    end
+
+    def default_input_required
+      @default_input_required.nil? ? Defaults::DEFAULT_INPUT_REQUIRED : @default_input_required
+    end
+
+    def default_job_lock_timeout
+      @default_job_lock_timeout || Defaults::DEFAULT_JOB_LOCK_TIMEOUT_MS
+    end
+
+    def default_job_request_timeout
+      @default_job_request_timeout || Defaults::DEFAULT_JOB_REQUEST_TIMEOUT_MS
+    end
+
+    def default_message_ttl
+      @default_message_ttl || Defaults::DEFAULT_MESSAGE_TTL_MS
+    end
+
+    def default_output_required
+      @default_output_required.nil? ? Defaults::DEFAULT_OUTPUT_REQUIRED : @default_output_required
+    end
+
+    def default_buffer
+      @default_buffer.nil? ? Defaults::DEFAULT_STREAMING_BUFFER : @default_buffer
+    end
+
+    def default_buffer_throttle
+      @default_buffer_throttle || Defaults::DEFAULT_BUFFER_THROTTLE_MS
+    end
+
+    def default_worker_mode
+      @default_worker_mode || Defaults::DEFAULT_WORKER_MODE
+    end
+
+    def grpc_retry_delay_ms
+      @grpc_retry_delay_ms || Defaults::DEFAULT_GRPC_RETRY_DELAY_MS
+    end
+
+    def grpc_retry_enabled
+      return @grpc_retry_enabled unless @grpc_retry_enabled.nil?
+
+      false
+    end
+
+    def grpc_retry_errors
+      @grpc_retry_errors || default_retry_errors
+    end
+
+    def log_format
+      @log_format || :text
+    end
+
+    def default_backpressure_delay
+      @default_backpressure_delay || Defaults::DEFAULT_BACKPRESSURE_DELAY_MS
+    end
+
+    def shutdown_on_errors
+      @shutdown_on_errors ||= []
+    end
+
+    def worker_name
+      return @worker_name if @worker_name
+      return ENV["BUSYBEE_WORKER_NAME"] if ENV["BUSYBEE_WORKER_NAME"]
+
+      Socket.gethostname
+    rescue StandardError
+      "busybee-worker"
+    end
+
+    private
+
+    def default_retry_errors
+      require "grpc"
+      [::GRPC::Unavailable, ::GRPC::DeadlineExceeded, ::GRPC::ResourceExhausted]
+    end
+  end
 end
+
+require "busybee/railtie" if defined?(Rails::Railtie)

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: busybee
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Andy Rusterholz
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-12-30 00:00:00.000000000 Z
+date: 2026-03-13 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
 - !ruby/object:Gem::Dependency
   name: base64
   requirement: !ruby/object:Gem::Requirement
@@ -24,6 +38,26 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.7
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.7
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: grpc
   requirement: !ruby/object:Gem::Requirement
@@ -44,26 +78,69 @@ description: The missing Ruby gem for Camunda 8. Production-ready worker framewo
   and CI/CD deployment tooling for BPMNs.
 email:
 - andyrusterholz@gmail.com
-executables: []
+executables:
+- busybee
 extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
+- docs/client.md
+- docs/client/quick_start.md
+- docs/configuration.md
 - docs/grpc.md
 - docs/testing.md
+- docs/workers.md
+- exe/busybee
 - lib/busybee.rb
+- lib/busybee/cli.rb
+- lib/busybee/client.rb
+- lib/busybee/client/error_handling.rb
+- lib/busybee/client/job_operations.rb
+- lib/busybee/client/message_operations.rb
+- lib/busybee/client/process_operations.rb
+- lib/busybee/client/variable_operations.rb
+- lib/busybee/configure.rb
+- lib/busybee/credentials.rb
+- lib/busybee/credentials/camunda_cloud.rb
+- lib/busybee/credentials/insecure.rb
+- lib/busybee/credentials/oauth.rb
+- lib/busybee/credentials/tls.rb
+- lib/busybee/defaults.rb
+- lib/busybee/error.rb
 - lib/busybee/grpc.rb
+- lib/busybee/grpc/error.rb
 - lib/busybee/grpc/gateway_pb.rb
 - lib/busybee/grpc/gateway_services_pb.rb
+- lib/busybee/job.rb
+- lib/busybee/job_stream.rb
+- lib/busybee/logging.rb
+- lib/busybee/railtie.rb
+- lib/busybee/runner.rb
+- lib/busybee/runner/hybrid.rb
+- lib/busybee/runner/multi.rb
+- lib/busybee/runner/polling.rb
+- lib/busybee/runner/streaming.rb
+- lib/busybee/runtime_config.rb
+- lib/busybee/serialization.rb
 - lib/busybee/testing.rb
 - lib/busybee/testing/activated_job.rb
 - lib/busybee/testing/helpers.rb
+- lib/busybee/testing/helpers/execution.rb
+- lib/busybee/testing/helpers/support.rb
+- lib/busybee/testing/matchers/complete_job.rb
+- lib/busybee/testing/matchers/fail_job.rb
 - lib/busybee/testing/matchers/have_activated.rb
+- lib/busybee/testing/matchers/have_available_jobs.rb
 - lib/busybee/testing/matchers/have_received_headers.rb
 - lib/busybee/testing/matchers/have_received_variables.rb
+- lib/busybee/testing/matchers/throw_bpmn_error_on.rb
 - lib/busybee/version.rb
+- lib/busybee/worker.rb
+- lib/busybee/worker/configuration.rb
+- lib/busybee/worker/dsl.rb
+- lib/busybee/worker/shutdown.rb
 homepage: https://github.com/rusterholz/busybee
 licenses:
 - MIT