event_people 1.2.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ccaafb3d62e2c63881bfc08b080e4f129d79911a6f5d1a1e2aa3929a2b719bff
-  data.tar.gz: 889f25c2629daa9ee21a6c3621435ffc0eaae30c0ea9335bbf94da82eec126b8
+  metadata.gz: c7f60b5a8806b69e26b0f66ea3a547e92200f460df4f30a2df90eed2fa08641d
+  data.tar.gz: 343c7a4e19f4a0194e552b507f3d000a1fd723faf374a35faee8961527c1809f
 SHA512:
-  metadata.gz: b615ef14921b27781edc64e48bb637965e1fb91d99995ec231a0b731b5f21bcdb73c8001528646e051c52d1ab86c6f70a92c8250521b668d983bfb52a805adcc
-  data.tar.gz: 33628df7e0a91b4247724173e354117cb28f39e83bdd8bd0711df2265b632c183b8185c8fabdc290c24dcab4f55e085761a846720ab8b12fd89b4f90fd17da8f
+  metadata.gz: dbd234e3c4df60f769feb130c05b8d96421677e8e297704b5620f41749ba3a507bfae2d22af9c020612d5fbb2b1f426bc427b8e71f476235de68a1fb806e1e38
+  data.tar.gz: 791f1ee04535ed6eef1d3fd9cb5771da399b336b946d9b4fef7f46b43d362781c6698a26aafac727620ef792f93a2f8fab6f2e59f3460655073c8a2937ab8600

data/.event_people.yml

@@ -1,5 +1,5 @@
-spec_version: "1.1.0"
-implementation_version: "1.2.0"
+spec_version: "1.1.1"
+implementation_version: "1.2.1"
 language: ruby
 package: "event_people (RubyGems)"
 status: stable

data/README.md

@@ -220,6 +220,65 @@ EventPeople::Daemon.start
 ```
 [See more details](https://github.com/pin-people/event_people_ruby/blob/master/examples/daemon.rb)
 
+## Retry and Dead Letter Queue (DLQ)
+
+### Environment variables
+
+| Variable | Description | Default |
+|---|---|---|
+| `RABBIT_EVENT_PEOPLE_MAX_RETRIES` | Max retry attempts before dead-lettering | `3` |
+| `RABBIT_EVENT_PEOPLE_RETRY_TTL_MS` | Base delay in ms for retry backoff | `1000` |
+
+### How it works
+
+On `context.fail`:
+- If retries remain → message published to `{queue}_retry` with exponential backoff delay, then acked
+- If retries exhausted → nacked to DLQ via RabbitMQ DLX
+
+On `context.reject` → nacked directly to DLQ (no retries)
+
+**Delay strategies:**
+- `exponential` (default): `min(initialDelay × 5^retry_count, 600000)` ms
+- `fixed`: constant `initialDelay` ms
+
+### Queue topology (auto-created on subscribe)
+
+| Queue/Exchange | Name | Purpose |
+|---|---|---|
+| Exchange (DLX) | `{app_name}_dlx` | Fanout, receives dead-lettered messages |
+| DLQ | `{app_name}_dlq` | Final resting place for failed messages |
+| Retry queue | `{queue_name}_retry` | Holds messages until backoff delay expires |
+
+### Usage
+
+```ruby
+class OrderListener < EventPeople::Listeners::Base
+  bind :handle_created, 'order.service.created'
+
+  def handle_created(event)
+    puts "Attempt #{event.retry_count + 1} of #{context.max_retries}"
+
+    if invalid?(event)
+      reject  # → DLQ immediately, no retries
+      return
+    end
+
+    process(event)
+    success
+  rescue StandardError
+    puts 'Final attempt, sending to DLQ' if context.is_last_retry
+    fail  # → retry queue (or DLQ if exhausted)
+  end
+end
+
+# Per-listener retry config (overrides env var defaults)
+EventPeople::Listener.on('order.service.created', method(:handle),
+                         max_attempts: 5,
+                         delay_strategy: 'exponential')
+```
+
+> **Note:** `success!`, `fail!`, `reject!` still work but are deprecated — prefer `success`, `fail`, `reject`.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `bundle exec rspec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

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

@@ -34,18 +34,23 @@ module EventPeople
               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.
+            # Publish failed — nack without requeue so the DLX routes to DLQ.
+            # Requeuing without incrementing x-event-people-retries would cause an infinite loop.
             begin
-              @channel.nack(@delivery_info.delivery_tag, false, true)
+              @channel.nack(@delivery_info.delivery_tag, false, false)
             rescue
               # Channel may already be closed; nothing we can do.
             end
             raise e
           end
+          begin
+            @channel.ack(@delivery_info.delivery_tag, false)
+          rescue
+            # Publish already succeeded; swallow ack errors. The message may be redelivered
+            # once (at-least-once), but that is safer than nacking to DLQ when a retry copy
+            # is already enqueued.
+          end
         else
           @channel.nack(@delivery_info.delivery_tag, false, false)
         end

data/lib/event_people/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: event_people
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.2.1
 platform: ruby
 authors:
 - Pin People
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-12 00:00:00.000000000 Z
+date: 2026-06-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler