event_people 1.0.7 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6177a8182d6ea892db42802e727cbfc8eb1de66341345d681ed124db88566cb5
-  data.tar.gz: f368ab8690d1544a13e2782090cf4aadae00ede029c1f9557098cdb8cb85eba2
+  metadata.gz: ccaafb3d62e2c63881bfc08b080e4f129d79911a6f5d1a1e2aa3929a2b719bff
+  data.tar.gz: 889f25c2629daa9ee21a6c3621435ffc0eaae30c0ea9335bbf94da82eec126b8
 SHA512:
-  metadata.gz: e7f0bec06ba76079f289270ec479a132ba1dc23b55cb0f14d5d822366c634e34a8f5033fc7ae86665d4e110eeb32dc623258791234a01dbd34e529e734766cbc
-  data.tar.gz: b5e9916f23b0a6d8e3bf041342e0f8f3e3f106498a51c9f3d27651bf99d29a820baac0ea3801844eb42bd3bd24f32c34f1d7a522224af4e5d3ebb6bbbe84ea28
+  metadata.gz: b615ef14921b27781edc64e48bb637965e1fb91d99995ec231a0b731b5f21bcdb73c8001528646e051c52d1ab86c6f70a92c8250521b668d983bfb52a805adcc
+  data.tar.gz: 33628df7e0a91b4247724173e354117cb28f39e83bdd8bd0711df2265b632c183b8185c8fabdc290c24dcab4f55e085761a846720ab8b12fd89b4f90fd17da8f

data/.event_people.yml

@@ -0,0 +1,41 @@
+spec_version: "1.1.0"
+implementation_version: "1.2.0"
+language: ruby
+package: "event_people (RubyGems)"
+status: stable
+
+# Components implemented (with deviations/bugs noted separately)
+implemented:
+  - Config
+  - Event
+  - Listener
+  - Emitter
+  - Daemon
+  - "Daemon.bindSignals"
+  - BaseListener
+  - ListenersManager
+  - BaseBroker
+  - RabbitBroker
+  - RabbitContext
+  - Topic
+  - Queue
+  - RetryManager
+  - "Event.retryCount"
+  - "Event.incrementRetryCount"
+  - "Config.maxAttempts"
+  - "Config.delayStrategy"
+  - "Config.dlqName"
+  - "Config.getRetryConfig"
+  - "Listener.on (retry params: maxAttempts, delayStrategy, dlqName)"
+  - "Context.maxRetries"
+  - "Context.isLastRetry"
+  - "RabbitContext.maxRetries"
+  - "RabbitContext.isLastRetry"
+  - "RabbitContext.dlqName"
+
+# Spec components not yet implemented (pending in spec too)
+pending: []
+
+# Structural or naming departures from the spec
+# (Ruby module-qualified class names are an accepted adaptation, not a deviation)
+deviations: []

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    event_people (1.0.7)
+    event_people (1.2.0)
       bunny (~> 2.7)
 
 GEM

data/lib/event_people/broker/base.rb

@@ -15,13 +15,13 @@ module EventPeople
         raise NotImplementedError.new('Must be implemented')
       end
 
-      def self.consume(event_name, &block)
+      def self.consume(event_name, retry_config: {}, &block)
         consumers[event_name] ||= begin
-          new.consume(event_name, &block)
+          new.consume(event_name, retry_config: retry_config, &block)
         end
       end
 
-      def consume(event_name, &block)
+      def consume(event_name, retry_config: {}, &block)
         raise NotImplementedError.new('Must be implemented')
       end
 

data/lib/event_people/broker/context.rb

@@ -1,17 +1,40 @@
 module EventPeople
   module Broker
     class Context
-      def success!
+      def success
         raise NotImplementedError.new('Must be implemented')
       end
 
-      def fail!
+      def fail
         raise NotImplementedError.new('Must be implemented')
       end
 
-      def reject!
+      def reject
+        raise NotImplementedError.new('Must be implemented')
+      end
+
+      def max_retries
+        raise NotImplementedError.new('Must be implemented')
+      end
+
+      def is_last_retry
         raise NotImplementedError.new('Must be implemented')
       end
+
+      def success!
+        warn '[DEPRECATED] EventPeople: `success!` is deprecated, use `success` instead. Will be removed in a future version.'
+        success
+      end
+
+      def fail!
+        warn '[DEPRECATED] EventPeople: `fail!` is deprecated, use `fail` instead. Will be removed in a future version.'
+        self.fail
+      end
+
+      def reject!
+        warn '[DEPRECATED] EventPeople: `reject!` is deprecated, use `reject` instead. Will be removed in a future version.'
+        reject
+      end
     end
   end
 end

data/lib/event_people/broker/rabbit/queue.rb

@@ -6,18 +6,21 @@ module EventPeople
         @channel.prefetch(1)
       end
 
-      def self.subscribe(channel, routing_key, &block)
-        new(channel).subscribe(routing_key, &block)
+      def self.subscribe(channel, routing_key, retry_config: {}, &block)
+        new(channel).subscribe(routing_key, retry_config: retry_config, &block)
       end
 
-      def subscribe(routing_key, &block)
+      def subscribe(routing_key, retry_config: {}, &block)
         base_name = routing_key.split('.')[0..2].join('.')
         name = queue_name("#{base_name}.all")
 
-        channel.queue(name, queue_options)
+        declare_dlx_and_dlq
+        declare_retry_queue(name)
+
+        channel.queue(name, main_queue_options)
                .bind(topic, routing_key: routing_key)
                .subscribe(manual_ack: true) do |delivery_info, properties, payload|
-                 callback(delivery_info, properties, payload, &block)
+                 callback(delivery_info, properties, payload, name, retry_config, &block)
                end
       end
 
@@ -25,11 +28,37 @@ module EventPeople
 
       attr_reader :channel
 
-      def callback(delivery_info, properties, payload, &block)
-        event_name = delivery_info.routing_key
+      def declare_dlx_and_dlq
+        dlx_name = "#{EventPeople::Config::APP_NAME}_dlx"
+        dlq_name = "#{EventPeople::Config::APP_NAME}_dlq"
+
+        dlx = channel.fanout(dlx_name, durable: true)
+        channel.queue(dlq_name, durable: true).bind(dlx, routing_key: '')
+      end
+
+      def declare_retry_queue(main_queue_name)
+        channel.queue("#{main_queue_name}_retry", durable: true, arguments: {
+          'x-dead-letter-exchange'    => '',
+          'x-dead-letter-routing-key' => main_queue_name
+        })
+      end
+
+      def callback(delivery_info, properties, payload, queue_name, retry_config, &block)
+        event_name  = delivery_info.routing_key
+        retry_count = [(properties.headers&.dig('x-event-people-retries') || 0).to_i, 0].max
+
+        event = EventPeople::Event.new(event_name, payload, 1.0, retry_count: retry_count)
 
-        event = EventPeople::Event.new(event_name, payload)
-        context = EventPeople::Broker::Rabbit::RabbitContext.new(channel, delivery_info)
+        context = EventPeople::Broker::Rabbit::RabbitContext.new(
+          channel,
+          delivery_info,
+          retry_count:      retry_count,
+          max_retries:      retry_config[:max_attempts],
+          delay_strategy:   retry_config[:delay_strategy],
+          dlq_name:         retry_config[:dlq_name],
+          queue_name:       queue_name,
+          original_payload: payload
+        )
 
         block.call(event, context)
       end
@@ -38,8 +67,11 @@ module EventPeople
         Rabbit::Topic.topic(channel)
       end
 
-      def queue_options
-        { durable: true }
+      def main_queue_options
+        {
+          durable:   true,
+          arguments: { 'x-dead-letter-exchange' => "#{EventPeople::Config::APP_NAME}_dlx" }
+        }
       end
 
       def queue_name(routing_key)

data/lib/event_people/broker/rabbit/rabbit_context.rb

@@ -1,22 +1,59 @@
 module EventPeople
   module Broker
     class Rabbit::RabbitContext < EventPeople::Broker::Context
-      def initialize(channel, delivery_info)
-        @channel = channel
-        @delivery_info = delivery_info
+      attr_reader :max_retries, :dlq_name
+
+      def initialize(channel, delivery_info, retry_count: 0, max_retries: nil, delay_strategy: nil, dlq_name: nil, queue_name: nil, original_payload: nil)
+        @channel          = channel
+        @delivery_info    = delivery_info
+        @retry_count      = retry_count.to_i
+        @max_retries      = (max_retries || EventPeople::Config::MAX_ATTEMPTS).to_i
+        @delay_strategy   = delay_strategy || EventPeople::Config::DELAY_STRATEGY
+        @dlq_name         = dlq_name || EventPeople::Config::DLQ_NAME
+        @queue_name       = queue_name
+        @original_payload = original_payload
+      end
+
+      def is_last_retry
+        @retry_count >= @max_retries - 1
       end
 
-      def success!
+      def success
         @channel.ack(@delivery_info.delivery_tag, false)
       end
 
-      def fail!
-        @channel.nack(@delivery_info.delivery_tag, false, true)
+      def fail
+        retry_manager = Rabbit::RetryManager.new(@max_retries, @delay_strategy)
+
+        if retry_manager.should_retry?(@retry_count)
+          delay = retry_manager.get_next_delay(@retry_count)
+          begin
+            @channel.default_exchange.publish(
+              @original_payload,
+              routing_key: "#{@queue_name}_retry",
+              expiration: delay.to_s,
+              headers: { 'x-event-people-retries' => @retry_count + 1 }
+            )
+            @channel.ack(@delivery_info.delivery_tag, false)
+          rescue => e
+            # If publish+ack fails, nack so the message is redelivered from the main queue.
+            # This risks duplication if publish succeeded but ack failed, which is an inherent
+            # AMQP at-least-once limitation. We prefer redelivery over silent loss.
+            begin
+              @channel.nack(@delivery_info.delivery_tag, false, true)
+            rescue
+              # Channel may already be closed; nothing we can do.
+            end
+            raise e
+          end
+        else
+          @channel.nack(@delivery_info.delivery_tag, false, false)
+        end
       end
 
-      def reject!
+      def reject
         @channel.reject(@delivery_info.delivery_tag, false)
       end
     end
   end
-end
+end

data/lib/event_people/broker/rabbit/retry_manager.rb

@@ -0,0 +1,25 @@
+module EventPeople
+  module Broker
+    class Rabbit::RetryManager
+      INITIAL_DELAY = (ENV['RABBIT_EVENT_PEOPLE_RETRY_TTL_MS'] || 1000).to_i
+      MAX_DELAY = 600_000
+
+      def initialize(max_attempts, delay_strategy = 'exponential')
+        @max_attempts   = max_attempts
+        @delay_strategy = delay_strategy
+      end
+
+      def should_retry?(retry_count)
+        retry_count < @max_attempts
+      end
+
+      def get_next_delay(retry_count)
+        if @delay_strategy == 'fixed'
+          INITIAL_DELAY
+        else
+          [INITIAL_DELAY * (5**retry_count), MAX_DELAY].min
+        end
+      end
+    end
+  end
+end

data/lib/event_people/broker/rabbit.rb

@@ -5,8 +5,8 @@ module EventPeople
         @@connection ||= session
       end
 
-      def consume(event_name, &block)
-        Queue.subscribe(channel, event_name, &block)
+      def consume(event_name, retry_config: {}, &block)
+        Queue.subscribe(channel, event_name, retry_config: retry_config, &block)
       end
 
       def produce(events)

data/lib/event_people/config.rb

@@ -6,8 +6,20 @@ module EventPeople
     URL      = ENV['RABBIT_URL']
     FULL_URL = "#{ENV['RABBIT_URL']}/#{ENV['RABBIT_EVENT_PEOPLE_VHOST']}"
 
+    MAX_ATTEMPTS   = (ENV['RABBIT_EVENT_PEOPLE_MAX_RETRIES'] || 3).to_i
+    DELAY_STRATEGY = 'exponential'
+    DLQ_NAME       = "#{ENV['RABBIT_EVENT_PEOPLE_APP_NAME']}_dlq"
+
     def self.broker
       EventPeople::Broker::Rabbit
     end
+
+    def self.get_retry_config
+      {
+        max_attempts:   MAX_ATTEMPTS,
+        delay_strategy: DELAY_STRATEGY,
+        dlq_name:       DLQ_NAME
+      }
+    end
   end
 end

data/lib/event_people/event.rb

@@ -1,11 +1,12 @@
 module EventPeople
   class Event
-    attr_reader :name, :headers, :body, :schema_version
+    attr_reader :name, :headers, :body, :schema_version, :retry_count
 
-    def initialize(name, body, schema_version = 1.0)
+    def initialize(name, body, schema_version = 1.0, retry_count: 0)
       @name = name
       @body = body.is_a?(String) ? JSON.parse(body) : body
       @schema_version = @body&.dig('headers', 'schemaVersion') || schema_version
+      @retry_count = retry_count.to_i
 
       if name?
         generate_headers
@@ -15,6 +16,10 @@ module EventPeople
       build_payload if @body&.key?('headers')
     end
 
+    def increment_retry_count
+      @retry_count += 1
+    end
+
     def payload
       { headers: headers, body: body }.to_json
     end

data/lib/event_people/listener.rb

@@ -2,16 +2,21 @@ require 'bunny'
 
 module EventPeople
   class Listener
-    def self.on(event_name, &block)
-      new.on(event_name, &block)
+    def self.on(event_name, max_attempts: nil, delay_strategy: nil, dlq_name: nil, &block)
+      new.on(event_name, max_attempts: max_attempts, delay_strategy: delay_strategy, dlq_name: dlq_name, &block)
     end
 
-    def on(event_name, &block)
+    def on(event_name, max_attempts: nil, delay_strategy: nil, dlq_name: nil, &block)
       raise(MissingAttributeError, 'Event name must be present') unless event_name&.size&.positive?
 
       event_name = consumed_event_name(event_name)
 
-      EventPeople::Config.broker.consume(event_name, &block)
+      retry_config = EventPeople::Config.get_retry_config
+      retry_config[:max_attempts]   = max_attempts   unless max_attempts.nil?
+      retry_config[:delay_strategy] = delay_strategy unless delay_strategy.nil?
+      retry_config[:dlq_name]       = dlq_name       unless dlq_name.nil?
+
+      EventPeople::Config.broker.consume(event_name, retry_config: retry_config, &block)
     end
 
     private

data/lib/event_people/listeners/base.rb

@@ -9,16 +9,31 @@ module EventPeople
         send method_name, event
       end
 
+      def success
+        @context.success
+      end
+
+      def fail
+        @context.fail
+      end
+
+      def reject
+        @context.reject
+      end
+
       def success!
-        @context.success!
+        warn '[DEPRECATED] EventPeople: `success!` is deprecated, use `success` instead. Will be removed in a future version.'
+        success
       end
 
       def fail!
-        @context.fail!
+        warn '[DEPRECATED] EventPeople: `fail!` is deprecated, use `fail` instead. Will be removed in a future version.'
+        self.fail
       end
 
       def reject!
-        @context.reject!
+        warn '[DEPRECATED] EventPeople: `reject!` is deprecated, use `reject` instead. Will be removed in a future version.'
+        reject
       end
 
       def self.bind(method, event_name)

data/lib/event_people/version.rb

@@ -1,3 +1,3 @@
 module EventPeople
-  VERSION = '1.0.7'
+  VERSION = '1.2.0'
 end

data/lib/event_people.rb

@@ -11,6 +11,7 @@ require 'event_people/broker/context'
 require 'event_people/broker/rabbit'
 require 'event_people/broker/rabbit/queue'
 require 'event_people/broker/rabbit/rabbit_context'
+require 'event_people/broker/rabbit/retry_manager'
 require 'event_people/broker/rabbit/topic'
 
 module EventPeople

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: event_people
 version: !ruby/object:Gem::Version
-  version: 1.0.7
+  version: 1.2.0
 platform: ruby
 authors:
 - Pin People
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-03-13 00:00:00.000000000 Z
+date: 2026-06-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -89,6 +89,7 @@ extra_rdoc_files: []
 files:
 - ".circleci/config.yml"
 - ".env.example"
+- ".event_people.yml"
 - ".gitignore"
 - ".rspec"
 - ".ruby-version"
@@ -108,6 +109,7 @@ files:
 - lib/event_people/broker/rabbit.rb
 - lib/event_people/broker/rabbit/queue.rb
 - lib/event_people/broker/rabbit/rabbit_context.rb
+- lib/event_people/broker/rabbit/retry_manager.rb
 - lib/event_people/broker/rabbit/topic.rb
 - lib/event_people/config.rb
 - lib/event_people/daemon.rb