legionio 1.8.1 → 1.8.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f077a3f850a9690fe5fc70f6dd0ddb5ddf4192ffc0709dd6c254d873e4ccfcbc
-  data.tar.gz: 2823a8a14bd3603bbaaf40356ae18cc95d6f11fc32b6335e3bfcbd69bcdef8b5
+  metadata.gz: 274f2876b6e344eba4a13f69464f8d2314184ac72b421758d8fbc54b40934fa7
+  data.tar.gz: 7fa9c97c435509b18b2f68cdc2a041f496b613a7cf163b053c5d286a2ae9870a
 SHA512:
-  metadata.gz: 4be6ec4e8ce8c669a8b0793180508b68473a4e2bab97ecb355978150bdb9783b726719746dd493039276a97283263d122c9c5f9cc915cf056c395736466d2d83
-  data.tar.gz: 7894f7a66b5648032d850ef8570db60b812fa1f65e7e4936d077003967e8183bb6a75ea363a715bff53c855e684f1d55c9d4936580be8f49be8ef4a361bc0473
+  metadata.gz: 64226b609440433ddf6db4bcfaf102318e50d22ed6a117ddf113086fb85988d4df4dfecd1d162c20d5e5b1d1b5e4a69dbc8a426b5b5a05e6f9a83fb7e4add5f8
+  data.tar.gz: 4ddd4175e2584e249e6e74e4101d6ed3ae15be7d60b3051e9025f8f8bb286e84cba73e00a1715443abd1cae216249b7328aed9daeb66ed8558282385f618dcf5

data/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## [Unreleased]
 
+## [1.8.2] - 2026-04-13
+
+### Added
+- `Legion::Extensions::Actors::RetryPolicy` — configurable retry threshold module with `should_retry?`, `extract_retry_count`, and `retry_threshold` helpers
+- Subscription actor `reject_or_retry` — counts retries via `x-retry-count` header, republishes with incremented header and exponential backoff (`2^n * base_delay`, capped at `max_delay`), dead-letters to DLX when threshold exceeded
+- Settings: `fleet.poison_message_threshold` (primary), `transport.retry_threshold` (fallback), `fleet.transport.retry_base_delay_seconds`, `fleet.transport.retry_max_delay_seconds`
+
 ## [1.7.37] - 2026-04-09
 
 ### Added

data/lib/legion/extensions/actors/retry_policy.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Actors
+      module RetryPolicy
+        DEFAULT_THRESHOLD = 2
+        RETRY_COUNT_HEADER = 'x-retry-count'
+
+        module_function
+
+        def should_retry?(retry_count:, threshold:)
+          return true if threshold.nil?
+
+          retry_count < threshold
+        end
+
+        def extract_retry_count(headers)
+          return 0 if headers.nil?
+
+          count = headers[RETRY_COUNT_HEADER] || headers[RETRY_COUNT_HEADER.to_sym] || 0
+          count.to_i
+        end
+
+        def retry_threshold
+          threshold = nil
+          if defined?(Legion::Settings)
+            threshold = Legion::Settings.dig(:fleet, :poison_message_threshold)
+            threshold ||= Legion::Settings.dig(:transport, :retry_threshold)
+          end
+          threshold || DEFAULT_THRESHOLD
+        rescue StandardError
+          DEFAULT_THRESHOLD
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/actors/subscription.rb

@@ -2,6 +2,7 @@
 
 require_relative 'base'
 require_relative 'dsl'
+require_relative 'retry_policy'
 require 'date'
 require 'securerandom'
 
@@ -84,7 +85,7 @@ module Legion
             cancel if Legion::Settings[:client][:shutting_down]
           rescue StandardError => e
             handle_exception(e, lex: lex_name, fn: fn, routing_key: delivery_info.routing_key)
-            @queue.reject(delivery_info.delivery_tag) if manual_ack
+            reject_or_retry(delivery_info, metadata, payload) if manual_ack
           end
           log.info "[Subscription] prepared: #{lex_name}/#{runner_name}"
         rescue StandardError => e
@@ -176,8 +177,8 @@ module Legion
             cancel if Legion::Settings[:client][:shutting_down]
           rescue StandardError => e
             handle_exception(e)
-            log.warn "[Subscription] nacking message for #{lex_name}/#{fn}"
-            @queue.reject(delivery_info.delivery_tag) if manual_ack
+            log.warn "[Subscription] retry-or-dlq for #{lex_name}/#{fn}"
+            reject_or_retry(delivery_info, metadata, payload) if manual_ack
           end
           log.info "[Subscription] subscribed: #{lex_name}/#{runner_name} (consumer registered)" if defined?(log)
         end
@@ -223,6 +224,47 @@ module Legion
             run_block.call
           end
         end
+
+        def reject_or_retry(delivery_info, metadata, payload)
+          headers = metadata&.headers || {}
+          retry_count = RetryPolicy.extract_retry_count(headers)
+          threshold = RetryPolicy.retry_threshold
+
+          if RetryPolicy.should_retry?(retry_count: retry_count, threshold: threshold)
+            base_delay = Legion::Settings.dig(:fleet, :transport, :retry_base_delay_seconds) || 1
+            max_delay = Legion::Settings.dig(:fleet, :transport, :retry_max_delay_seconds) || 30
+            delay = [base_delay * (2**retry_count), max_delay].min
+            log.info "[Subscription] retrying message in #{delay}s (attempt #{retry_count + 1}/#{threshold}) for #{lex_name}"
+            sleep(delay)
+            if republish_with_retry_count(delivery_info, metadata, payload, retry_count + 1)
+              @queue.acknowledge(delivery_info.delivery_tag)
+            else
+              @queue.reject(delivery_info.delivery_tag, requeue: false)
+            end
+          else
+            log.warn "[Subscription] dead-lettering message after #{retry_count} retries for #{lex_name}"
+            @queue.reject(delivery_info.delivery_tag, requeue: false)
+          end
+        end
+
+        def republish_with_retry_count(_delivery_info, metadata, payload, new_count)
+          headers = (metadata&.headers || {}).dup
+          headers[RetryPolicy::RETRY_COUNT_HEADER] = new_count
+
+          exchange = @queue.channel.default_exchange
+          exchange.publish(
+            payload,
+            routing_key:      @queue.name,
+            headers:          headers,
+            content_type:     metadata&.content_type,
+            content_encoding: metadata&.content_encoding,
+            persistent:       true
+          )
+          true
+        rescue StandardError => e
+          log.warn "[Subscription] republish failed, dead-lettering: #{e.message}"
+          false
+        end
       end
     end
   end

data/lib/legion/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Legion
-  VERSION = '1.8.1'
+  VERSION = '1.8.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legionio
 version: !ruby/object:Gem::Version
-  version: 1.8.1
+  version: 1.8.2
 platform: ruby
 authors:
 - Esity
@@ -809,6 +809,7 @@ files:
 - lib/legion/extensions/actors/nothing.rb
 - lib/legion/extensions/actors/once.rb
 - lib/legion/extensions/actors/poll.rb
+- lib/legion/extensions/actors/retry_policy.rb
 - lib/legion/extensions/actors/singleton.rb
 - lib/legion/extensions/actors/subscription.rb
 - lib/legion/extensions/builders/absorbers.rb