event_engine-delivery 0.1.0

data/lib/tasks/event_engine_dead_letters.rake

@@ -0,0 +1,65 @@
+namespace :event_engine do
+  namespace :dead_letters do
+    desc "List all dead-lettered events"
+    task list: :environment do
+      events = EventEngine::OutboxEvent.dead_lettered.ordered
+
+      if events.empty?
+        puts "No dead-lettered events found."
+        next
+      end
+
+      puts "Dead-lettered events:"
+      puts "-" * 80
+      printf "%-10s %-30s %-10s %-20s\n", "ID", "Event Name", "Attempts", "Dead Lettered At"
+      puts "-" * 80
+
+      events.each do |event|
+        printf "%-10s %-30s %-10s %-20s\n",
+          event.id,
+          event.event_name.truncate(30),
+          event.attempts,
+          event.dead_lettered_at.strftime("%Y-%m-%d %H:%M:%S")
+      end
+
+      puts "-" * 80
+      puts "Total: #{events.count} event(s)"
+    end
+
+    desc "Retry a dead-lettered event by ID"
+    task :retry, [:event_id] => :environment do |_t, args|
+      event_id = args[:event_id]
+
+      unless event_id
+        puts "Usage: rake event_engine:dead_letters:retry[EVENT_ID]"
+        next
+      end
+
+      event = EventEngine::OutboxEvent.dead_lettered.find_by(id: event_id)
+
+      unless event
+        puts "No dead-lettered event found with ID #{event_id}"
+        next
+      end
+
+      event.retry!
+      puts "Retried 1 event (ID: #{event.id})"
+    end
+
+    namespace :retry do
+      desc "Retry all dead-lettered events"
+      task all: :environment do
+        events = EventEngine::OutboxEvent.dead_lettered
+        count = events.count
+
+        if count.zero?
+          puts "No dead-lettered events to retry."
+          next
+        end
+
+        events.find_each(&:retry!)
+        puts "Retried #{count} event(s)"
+      end
+    end
+  end
+end

data/lib/tasks/event_engine_outbox.rake

@@ -0,0 +1,25 @@
+namespace :event_engine do
+  namespace :outbox do
+    desc "Delete published events older than retention_period"
+    task cleanup: :environment do
+      retention_period = EventEngine::Delivery.configuration.retention_period
+
+      unless retention_period
+        puts "retention_period not configured. Set config.retention_period in your initializer."
+        next
+      end
+
+      cutoff = Time.current - retention_period
+      events = EventEngine::OutboxEvent.cleanable.published_before(cutoff)
+      count = events.count
+
+      if count.zero?
+        puts "No events to clean up."
+        next
+      end
+
+      events.delete_all
+      puts "Deleted #{count} event(s) published before #{cutoff}"
+    end
+  end
+end

data/lib/tasks/event_engine_schema.rake

@@ -0,0 +1,49 @@
+namespace :event_engine do
+  desc "Fail if event schema DSL has drifted from db/event_schema.rb"
+  task schema: :environment do
+    EventEngine::DefinitionLoader.ensure_loaded!
+
+    descendants = EventEngine::EventDefinition.descendants
+
+    if descendants.empty?
+      raise <<~MSG
+        EventEngine found no EventDefinitions.
+
+        Expected definitions to be loaded during eager load.
+        Ensure they live in an eager-load path (e.g. app/event_definitions).
+      MSG
+    end
+
+    EventEngine::SchemaDriftGuard.check!(
+      schema_path: Rails.root.join("db/event_schema.rb"),
+      definitions: descendants
+    )
+  end
+
+  namespace :schema do
+    desc "Regenerate event_schema.rb from EventDefinitions"
+    task dump: :environment do
+      EventEngine::DefinitionLoader.ensure_loaded!
+
+      descendants = EventEngine::EventDefinition.descendants
+
+      if descendants.empty?
+        raise <<~MSG
+          EventEngine found no EventDefinitions.
+
+          Expected definitions to be loaded during eager load.
+          Ensure they live in an eager-load path (e.g. app/event_definitions).
+        MSG
+      end
+      
+      path = Rails.root.join("db/event_schema.rb")
+
+      EventEngine::EventSchemaDumper.dump!(
+        definitions: descendants,
+        path: path
+      )
+
+      puts "Dumping EventEngine schema to #{path}"
+    end
+  end
+end

data/lib/tasks/event_engine_schema_check.rake

@@ -0,0 +1,20 @@
+namespace :event_engine do
+  desc "Fail if event schema DSL has drifted from db/event_schema.rb"
+  task schema_check: :environment do
+    compiled = EventEngine.compiled_schema_registry
+    file = EventEngine.file_schema_registry
+
+    if EventEngine::EventSchemaMerger.changed?(compiled, file)
+      raise <<~MSG
+        Schema drift detected.
+
+        The compiled EventDefinitions differ from db/event_schema.rb.
+
+        Run:
+          bin/rails event_engine:schema:dump
+
+        Then commit the updated schema file.
+      MSG
+    end
+  end
+end

data/lib/tasks/event_engine_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :event_engine do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,183 @@
+--- !ruby/object:Gem::Specification
+name: event_engine-delivery
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- tylercschneider
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.1.6
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.1.6
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+- !ruby/object:Gem::Dependency
+  name: event_engine
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: event_engine-subscribers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: event_engine-event_definition
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
+description: 'The delivery layer for EventEngine: the durability level ladder (0-4),
+  transactional outbox, retry, dead-letter handling, and pluggable transports. Depends
+  on event_engine for event definitions and schema.'
+email:
+- tylercschneider@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/assets/config/event_engine_manifest.js
+- app/assets/stylesheets/event_engine/application.css
+- app/controllers/event_engine/application_controller.rb
+- app/helpers/event_engine/application_helper.rb
+- app/jobs/event_engine/application_job.rb
+- app/jobs/event_engine/outbox_cleanup_job.rb
+- app/jobs/event_engine/publish_outbox_events_job.rb
+- app/mailers/event_engine/application_mailer.rb
+- app/models/event_engine/application_record.rb
+- app/models/event_engine/outbox_event.rb
+- app/views/layouts/event_engine/application.html.erb
+- config/routes.rb
+- db/migrate/20251216190654_create_event_engine_outbox_events.rb
+- db/migrate/20251216194009_add_event_type_to_event_engine_outbox_events.rb
+- db/migrate/20251216201941_add_payload_to_event_engine_outbox_events.rb
+- db/migrate/20251216203339_add_published_at_to_event_engine_outbox_events.rb
+- db/migrate/20251216213819_add_idempotency_key_to_event_engine_outbox_events.rb
+- db/migrate/20251217155422_add_attempts_to_event_engine_outbox_events.rb
+- db/migrate/20251217174013_add_dead_lettered_at_to_event_engine_outbox_events.rb
+- db/migrate/20251220213944_add_event_version_to_outbox_events.rb
+- db/migrate/20251221193107_add_occurred_at_and_metadata_to_outbox_events.rb
+- db/migrate/20260127000000_add_indexes_to_event_engine_outbox_events.rb
+- db/migrate/20260212000001_add_constraints_and_indexes_to_event_engine_outbox_events.rb
+- db/migrate/20260212000002_add_error_context_to_event_engine_outbox_events.rb
+- db/migrate/20260212000003_add_aggregate_columns_to_event_engine_outbox_events.rb
+- db/migrate/20260212000005_add_process_type_to_event_engine_outbox_events.rb
+- db/migrate/20260921000000_add_subject_and_domain_to_event_engine_outbox_events.rb
+- lib/event_engine-delivery.rb
+- lib/event_engine/cloud/api_client.rb
+- lib/event_engine/cloud/batch.rb
+- lib/event_engine/cloud/reporter.rb
+- lib/event_engine/cloud/serializer.rb
+- lib/event_engine/cloud/subscribers.rb
+- lib/event_engine/definition_transport_check.rb
+- lib/event_engine/delivery.rb
+- lib/event_engine/delivery/configuration.rb
+- lib/event_engine/delivery/engine.rb
+- lib/event_engine/delivery/handler.rb
+- lib/event_engine/delivery/version.rb
+- lib/event_engine/kafka_producer.rb
+- lib/event_engine/locking_strategy.rb
+- lib/event_engine/outbox_publisher.rb
+- lib/event_engine/outbox_router.rb
+- lib/event_engine/outbox_writer.rb
+- lib/event_engine/transports/in_memory_transport.rb
+- lib/event_engine/transports/kafka.rb
+- lib/event_engine/transports/null_transport.rb
+- lib/generators/event_engine/install_generator.rb
+- lib/generators/event_engine/templates/event_schema.rb
+- lib/generators/event_engine/templates/initializer.rb
+- lib/tasks/event_engine_dead_letters.rake
+- lib/tasks/event_engine_outbox.rake
+- lib/tasks/event_engine_schema.rake
+- lib/tasks/event_engine_schema_check.rake
+- lib/tasks/event_engine_tasks.rake
+homepage: https://github.com/tylercschneider/event_engine-delivery
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/tylercschneider/event_engine-delivery
+  source_code_uri: https://github.com/tylercschneider/event_engine-delivery
+  changelog_uri: https://github.com/tylercschneider/event_engine-delivery/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/tylercschneider/event_engine-delivery/issues
+  documentation_uri: https://github.com/tylercschneider/event_engine-delivery#readme
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.20
+specification_version: 4
+summary: Reliable event delivery for EventEngine
+test_files: []