leopard 0.2.4 → 0.2.6

data/lib/leopard/nats_request_reply_callbacks.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module Rubyists
+  module Leopard
+    # Maps Leopard handler outcomes to request/reply response behavior.
+    class NatsRequestReplyCallbacks
+      # Builds a callback set for request/reply endpoint outcomes.
+      #
+      # @param logger [#error] Logger used for failure payloads.
+      #
+      # @return [void]
+      def initialize(logger:)
+        @logger = logger
+      end
+
+      # Returns transport callbacks for request/reply endpoints.
+      #
+      # @return [Hash{Symbol => #call}] Outcome callbacks keyed by `:on_success`, `:on_failure`, and `:on_error`.
+      def callbacks
+        {
+          on_success: method(:respond_with_success),
+          on_failure: method(:respond_with_failure),
+          on_error: method(:respond_with_error),
+        }
+      end
+
+      private
+
+      # Responds to a successful request with the handler payload.
+      #
+      # @param wrapper [MessageWrapper] Wrapped request message.
+      # @param result [Dry::Monads::Success] Successful handler result.
+      #
+      # @return [void]
+      def respond_with_success(wrapper, result)
+        wrapper.respond(result.value!)
+      end
+
+      # Responds to a failed request with the failure payload.
+      #
+      # @param wrapper [MessageWrapper] Wrapped request message.
+      # @param result [Dry::Monads::Failure] Failed handler result.
+      #
+      # @return [void]
+      def respond_with_failure(wrapper, result)
+        log_failure(result.failure)
+        wrapper.respond_with_error(result.failure)
+      end
+
+      # Responds to a request with an exception payload after an unhandled error.
+      #
+      # @param wrapper [MessageWrapper] Wrapped request message.
+      # @param error [StandardError] The unhandled exception.
+      #
+      # @return [void]
+      def respond_with_error(wrapper, error)
+        wrapper.respond_with_error(error)
+      end
+
+      # Logs the failure payload returned by a handler.
+      #
+      # @param failure [Object] The failure payload from the handler.
+      #
+      # @return [void]
+      def log_failure(failure)
+        @logger.error 'Error processing message: ', failure
+      end
+    end
+  end
+end

data/lib/leopard/templates/prometheus_metrics.erb

@@ -0,0 +1,17 @@
+# HELP leopard_subject_busy_instances Instances currently processing a message on this subject
+# TYPE leopard_subject_busy_instances gauge
+<% subjects.each do |subject| -%>
+leopard_subject_busy_instances{subject="<%= subject %>"} <%= busy[subject] %>
+<% end -%>
+
+# HELP leopard_subject_total_instances Total Leopard instances in this process
+# TYPE leopard_subject_total_instances gauge
+<% subjects.each do |subject| -%>
+leopard_subject_total_instances{subject="<%= subject %>"} <%= total %>
+<% end -%>
+
+# HELP leopard_subject_pending_messages Messages pending processing across all instances
+# TYPE leopard_subject_pending_messages gauge
+<% subjects.each do |subject| -%>
+leopard_subject_pending_messages{subject="<%= subject %>"} <%= pending[subject] %>
+<% end -%>

data/lib/leopard/version.rb

@@ -3,7 +3,7 @@
 module Rubyists
   module Leopard
     # x-release-please-start-version
-    VERSION = '0.2.4'
+    VERSION = '0.2.6'
     # x-release-please-end
   end
 end

data/lib/leopard.rb

@@ -1,16 +1,28 @@
 # frozen_string_literal: true
 
 require 'dry/configurable'
+require 'dry/monads'
 require 'pathname'
 require 'semantic_logger'
 
+##
+# Namespace for Leopard and related helper extensions.
 class Pathname
+  # Joins the receiver with another path fragment.
+  #
+  # @param other [#to_s] The path fragment to append.
+  #
+  # @return [Pathname] The combined path.
   def /(other)
     join other.to_s
   end
 end
 
+##
+# Top-level namespace for Rubyists gems.
 module Rubyists
+  ##
+  # Namespace for Leopard runtime, DSL, and support classes.
   module Leopard
   end
 end
@@ -18,3 +30,8 @@ end
 require_relative 'leopard/settings'
 require_relative 'leopard/version'
 require_relative 'leopard/errors'
+require_relative 'leopard/message_processor'
+require_relative 'leopard/nats_jetstream_endpoint'
+require_relative 'leopard/nats_jetstream_callbacks'
+require_relative 'leopard/nats_jetstream_consumer'
+require_relative 'leopard/nats_request_reply_callbacks'

data/mise.toml

@@ -0,0 +1,2 @@
+[tools]
+ruby = "latest"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: leopard
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.2.6
 platform: ruby
 authors:
 - bougyman
 bindir: exe
 cert_chain: []
-date: 2026-03-31 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -91,6 +91,7 @@ files:
 - ".release-please-manifest.json"
 - ".rubocop.yml"
 - ".version.txt"
+- ".yardopts"
 - CHANGELOG.md
 - Rakefile
 - Readme.adoc
@@ -100,12 +101,21 @@ files:
 - ci/publish-gem.sh
 - doc/service-api-vs-rest.adoc
 - examples/echo_endpoint.rb
+- examples/jetstream_endpoint.rb
 - lib/leopard.rb
 - lib/leopard/errors.rb
+- lib/leopard/message_processor.rb
 - lib/leopard/message_wrapper.rb
+- lib/leopard/metrics_server.rb
 - lib/leopard/nats_api_server.rb
+- lib/leopard/nats_jetstream_callbacks.rb
+- lib/leopard/nats_jetstream_consumer.rb
+- lib/leopard/nats_jetstream_endpoint.rb
+- lib/leopard/nats_request_reply_callbacks.rb
 - lib/leopard/settings.rb
+- lib/leopard/templates/prometheus_metrics.erb
 - lib/leopard/version.rb
+- mise.toml
 homepage: https://github.com/rubyists/leopard
 licenses:
 - MIT
@@ -129,7 +139,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 4.0.6
 specification_version: 4
 summary: A server to supervise concurrent NATS ServiceApi workers.
 test_files: []