rails_webhook_outbox 0.2.0 → 0.4.0

data/app/views/rails_webhook_outbox/deliveries/index.html.erb

@@ -0,0 +1,62 @@
+<div class="rwo-header">
+  <h1>Deliveries</h1>
+</div>
+
+<%= form_with url: deliveries_path, method: :get, local: true, class: "rwo-filters" do %>
+  <div class="rwo-field">
+    <%= label_tag :status, "Status" %>
+    <%= select_tag :status,
+          options_for_select([["All", ""]] + RailsWebhookOutbox::Delivery.statuses.keys.map { |s| [s.capitalize, s] }, @status),
+          class: "rwo-select" %>
+  </div>
+
+  <div class="rwo-field">
+    <%= label_tag :event, "Event" %>
+    <%= select_tag :event,
+          options_for_select([["All", ""]] + RailsWebhookOutbox.config.events, @event),
+          class: "rwo-select" %>
+  </div>
+
+  <div class="rwo-field">
+    <%= label_tag :from, "From" %>
+    <%= date_field_tag :from, @from, class: "rwo-input" %>
+  </div>
+
+  <div class="rwo-field">
+    <%= label_tag :to, "To" %>
+    <%= date_field_tag :to, @to, class: "rwo-input" %>
+  </div>
+
+  <%= submit_tag "Filter", class: "rwo-btn" %>
+  <%= link_to "Reset", deliveries_path, class: "rwo-btn-reset" %>
+<% end %>
+
+<%= turbo_stream_from "rails_webhook_outbox_deliveries" %>
+
+<% if @deliveries.empty? %>
+  <p class="rwo-empty">No deliveries found.</p>
+<% else %>
+  <table class="rwo-table">
+    <thead>
+      <tr>
+        <th>Event</th>
+        <th>Subscription</th>
+        <th>Status</th>
+        <th>Attempts</th>
+        <th>Created</th>
+      </tr>
+    </thead>
+    <tbody>
+      <%= render partial: "row", collection: @deliveries, as: :delivery %>
+    </tbody>
+  </table>
+
+  <div class="rwo-pagination">
+    <% if @page > 1 %>
+      <%= link_to "← Previous", deliveries_path(request.query_parameters.merge(page: @page - 1)), class: "rwo-btn-small" %>
+    <% end %>
+    <% if @page * RailsWebhookOutbox::DeliveriesController::PER_PAGE < @total_count %>
+      <%= link_to "Next →", deliveries_path(request.query_parameters.merge(page: @page + 1)), class: "rwo-btn-small" %>
+    <% end %>
+  </div>
+<% end %>

data/app/views/rails_webhook_outbox/deliveries/retry.turbo_stream.erb

@@ -0,0 +1,2 @@
+<%= turbo_stream.replace dom_id(@delivery), partial: "rails_webhook_outbox/deliveries/row", locals: { delivery: @delivery } %>
+<%= turbo_stream.replace dom_id(@delivery, :detail), partial: "rails_webhook_outbox/deliveries/detail", locals: { delivery: @delivery } %>

data/app/views/rails_webhook_outbox/deliveries/show.html.erb

@@ -0,0 +1,5 @@
+<%= link_to "← All Deliveries", deliveries_path, class: "rwo-back" %>
+
+<%= turbo_stream_from @delivery %>
+
+<%= render "detail", delivery: @delivery %>

data/app/views/rails_webhook_outbox/events/index.html.erb

@@ -0,0 +1,22 @@
+<div class="rwo-header">
+  <h1>Registered Events</h1>
+</div>
+
+<% if @events.empty? %>
+  <p class="rwo-empty">No events registered. Set <code>config.events</code> in your initializer.</p>
+<% else %>
+  <% @events.each do |event| %>
+    <div class="rwo-event">
+      <div class="rwo-header-row">
+        <h2 class="rwo-section-title"><%= event[:name] %></h2>
+        <span class="rwo-muted"><%= event[:subscriber_count] %> active subscriber<%= "s" unless event[:subscriber_count] == 1 %></span>
+      </div>
+
+      <% if event[:example] %>
+        <pre class="rwo-monospace rwo-code-block"><%= JSON.pretty_generate(event[:example]) %></pre>
+      <% else %>
+        <p class="rwo-muted">No deliveries yet for this event.</p>
+      <% end %>
+    </div>
+  <% end %>
+<% end %>

data/app/views/rails_webhook_outbox/overview/_recent_failures.html.erb

@@ -0,0 +1,29 @@
+<div id="<%= RailsWebhookOutbox::Overview::FAILURES_TARGET %>">
+  <h2 class="rwo-section-title">Recent Failures</h2>
+
+  <% failures = overview.recent_failures %>
+  <% if failures.empty? %>
+    <p class="rwo-empty">No failed deliveries.</p>
+  <% else %>
+    <table class="rwo-table">
+      <thead>
+        <tr>
+          <th>Event</th>
+          <th>Subscription</th>
+          <th>Attempts</th>
+          <th>Created</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% failures.each do |delivery| %>
+          <tr>
+            <td><%= link_to delivery.event, delivery_path(delivery) %></td>
+            <td><%= delivery.subscription.url %></td>
+            <td class="rwo-muted"><%= delivery.attempts %></td>
+            <td class="rwo-muted"><%= delivery.created_at.strftime("%Y-%m-%d %H:%M:%S") %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% end %>
+</div>

data/app/views/rails_webhook_outbox/overview/_stats.html.erb

@@ -0,0 +1,19 @@
+<div id="<%= RailsWebhookOutbox::Overview::STATS_TARGET %>" class="rwo-stats-grid">
+  <div class="rwo-stat">
+    <div class="rwo-stat-label">Subscriptions</div>
+    <div class="rwo-stat-value"><%= link_to overview.subscription_count, subscriptions_path %></div>
+    <div class="rwo-muted"><%= overview.active_subscription_count %> active</div>
+  </div>
+  <div class="rwo-stat">
+    <div class="rwo-stat-label">Delivered</div>
+    <div class="rwo-stat-value"><%= link_to overview.delivery_count(:delivered), deliveries_path(status: "delivered") %></div>
+  </div>
+  <div class="rwo-stat">
+    <div class="rwo-stat-label">Pending</div>
+    <div class="rwo-stat-value"><%= link_to overview.delivery_count(:pending), deliveries_path(status: "pending") %></div>
+  </div>
+  <div class="rwo-stat">
+    <div class="rwo-stat-label">Failed</div>
+    <div class="rwo-stat-value"><%= link_to overview.delivery_count(:failed), deliveries_path(status: "failed") %></div>
+  </div>
+</div>

data/app/views/rails_webhook_outbox/overview/show.html.erb

@@ -0,0 +1,8 @@
+<div class="rwo-header">
+  <h1>Overview</h1>
+</div>
+
+<%= turbo_stream_from RailsWebhookOutbox::Overview::STREAM %>
+
+<%= render "stats", overview: @overview %>
+<%= render "recent_failures", overview: @overview %>

data/app/views/rails_webhook_outbox/subscriptions/_form.html.erb

@@ -0,0 +1,49 @@
+<%= form_with model: subscription, url: subscription.persisted? ? subscription_path(subscription) : subscriptions_path, local: true, class: "rwo-form" do |form| %>
+  <% if subscription.errors.any? %>
+    <div class="rwo-alert">
+      <ul>
+        <% subscription.errors.full_messages.each do |message| %>
+          <li><%= message %></li>
+        <% end %>
+      </ul>
+    </div>
+  <% end %>
+
+  <div class="rwo-field">
+    <%= form.label :url %>
+    <%= form.text_field :url, class: "rwo-input", placeholder: "https://example.com/webhooks" %>
+  </div>
+
+  <div class="rwo-field">
+    <%= form.label :events %>
+    <% if RailsWebhookOutbox.config.events.any? %>
+      <div class="rwo-checkbox-group">
+        <%= hidden_field_tag "subscription[events][]", "", id: nil %>
+        <% RailsWebhookOutbox.config.events.each do |event| %>
+          <label class="rwo-checkbox-label">
+            <%= check_box_tag "subscription[events][]", event, subscription.events.include?(event), id: nil %>
+            <%= event %>
+          </label>
+        <% end %>
+      </div>
+    <% else %>
+      <%= form.text_field :events, name: "subscription[events]", value: subscription.events.join(", "), class: "rwo-input", placeholder: "order.created, order.updated" %>
+    <% end %>
+  </div>
+
+  <div class="rwo-field">
+    <%= form.label :description %>
+    <%= form.text_field :description, class: "rwo-input" %>
+  </div>
+
+  <% if subscription.persisted? %>
+    <div class="rwo-field">
+      <label class="rwo-checkbox-label">
+        <%= form.check_box :active %>
+        Active
+      </label>
+    </div>
+  <% end %>
+
+  <%= form.submit subscription.persisted? ? "Update Subscription" : "Create Subscription", class: "rwo-btn" %>
+<% end %>

data/app/views/rails_webhook_outbox/subscriptions/edit.html.erb

@@ -0,0 +1,7 @@
+<%= link_to "← Back", subscription_path(@subscription), class: "rwo-back" %>
+
+<div class="rwo-header">
+  <h1>Edit Subscription</h1>
+</div>
+
+<%= render "form", subscription: @subscription %>

data/app/views/rails_webhook_outbox/subscriptions/index.html.erb

@@ -0,0 +1,37 @@
+<div class="rwo-header rwo-header-row">
+  <h1>Subscriptions</h1>
+  <%= link_to "New Subscription", new_subscription_path, class: "rwo-btn" %>
+</div>
+
+<% if @subscriptions.empty? %>
+  <p class="rwo-empty">No subscriptions yet.</p>
+<% else %>
+  <table class="rwo-table">
+    <thead>
+      <tr>
+        <th>URL</th>
+        <th>Events</th>
+        <th>Status</th>
+        <th>Failures</th>
+        <th></th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @subscriptions.each do |subscription| %>
+        <tr>
+          <td><%= link_to subscription.url, subscription_path(subscription), class: "rwo-path" %></td>
+          <td class="rwo-muted"><%= subscription.events.join(", ") %></td>
+          <td><%= active_badge(subscription.active?) %></td>
+          <td class="rwo-muted"><%= subscription.consecutive_failures %></td>
+          <td>
+            <%= button_to(subscription.active? ? "Disable" : "Enable",
+                  subscription_path(subscription),
+                  method: :patch,
+                  params: { subscription: { active: !subscription.active? } },
+                  class: "rwo-btn-small") %>
+          </td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+<% end %>

data/app/views/rails_webhook_outbox/subscriptions/new.html.erb

@@ -0,0 +1,7 @@
+<%= link_to "← All Subscriptions", subscriptions_path, class: "rwo-back" %>
+
+<div class="rwo-header">
+  <h1>New Subscription</h1>
+</div>
+
+<%= render "form", subscription: @subscription %>

data/app/views/rails_webhook_outbox/subscriptions/show.html.erb

@@ -0,0 +1,49 @@
+<%= link_to "← All Subscriptions", subscriptions_path, class: "rwo-back" %>
+
+<div class="rwo-header rwo-header-row">
+  <h1><%= @subscription.url %></h1>
+  <%= link_to "Edit", edit_subscription_path(@subscription), class: "rwo-btn" %>
+</div>
+
+<% if params[:rotation_error] %>
+  <p class="rwo-alert">Secret rotation already in progress — the previous secret is still within its grace period.</p>
+<% end %>
+
+<div class="rwo-detail">
+  <div class="rwo-detail-grid">
+    <div class="rwo-detail-item">
+      <div class="rwo-detail-label">Status</div>
+      <div class="rwo-detail-value"><%= active_badge(@subscription.active?) %></div>
+    </div>
+    <div class="rwo-detail-item">
+      <div class="rwo-detail-label">Events</div>
+      <div class="rwo-detail-value"><%= @subscription.events.join(", ") %></div>
+    </div>
+    <div class="rwo-detail-item">
+      <div class="rwo-detail-label">Consecutive Failures</div>
+      <div class="rwo-detail-value"><%= @subscription.consecutive_failures %></div>
+    </div>
+    <div class="rwo-detail-item">
+      <div class="rwo-detail-label">Description</div>
+      <div class="rwo-detail-value"><%= @subscription.description.presence || "—" %></div>
+    </div>
+  </div>
+</div>
+
+<h2 class="rwo-section-title">Signing Secret</h2>
+
+<div class="rwo-secret" data-controller="secret" data-secret-value-value="<%= @subscription.secret %>">
+  <span class="rwo-secret-display rwo-monospace" data-secret-target="display"><%= masked_secret(@subscription.secret) %></span>
+  <button type="button" class="rwo-btn-small" data-action="click->secret#reveal" data-secret-target="revealButton">Reveal</button>
+  <button type="button" class="rwo-btn-small" data-action="click->secret#copy" data-secret-target="copyButton">Copy</button>
+  <span class="rwo-muted" hidden data-secret-target="copiedHint">Copied!</span>
+</div>
+
+<% if @subscription.previous_secret_active? %>
+  <p class="rwo-muted">Previous secret valid until <%= @subscription.previous_secret_expires_at.strftime("%Y-%m-%d %H:%M:%S") %>.</p>
+<% end %>
+
+<%= button_to "Rotate Secret", rotate_secret_subscription_path(@subscription),
+      method: :patch,
+      class: "rwo-btn-danger",
+      form: { data: { turbo_confirm: "Rotate the signing secret? Subscribers must be updated within the grace period." } } %>

data/config/importmap.rb

@@ -0,0 +1,6 @@
+pin "@hotwired/turbo", to: "https://cdn.jsdelivr.net/npm/@hotwired/turbo@8.0.23/dist/turbo.es2017-esm.js"
+pin "@hotwired/stimulus", to: "https://cdn.jsdelivr.net/npm/@hotwired/stimulus@3.2.2/dist/stimulus.js"
+pin "rails_webhook_outbox",                                to: "rails_webhook_outbox/application.js"
+pin "rails_webhook_outbox/controllers",                    to: "rails_webhook_outbox/controllers/index.js"
+pin "rails_webhook_outbox/controllers/application",        to: "rails_webhook_outbox/controllers/application.js"
+pin "rails_webhook_outbox/controllers/secret_controller",  to: "rails_webhook_outbox/controllers/secret_controller.js"

data/config/routes.rb

@@ -1,2 +1,19 @@
 RailsWebhookOutbox::Engine.routes.draw do
+  root to: "overview#show"
+
+  # Explicit :only keeps new/edit routes on Rails 7.2 in api_only host apps,
+  # where resources would otherwise omit them.
+  resources :subscriptions, only: [:index, :show, :new, :create, :edit, :update, :destroy] do
+    member do
+      patch :rotate_secret
+    end
+  end
+
+  resources :deliveries, only: [:index, :show] do
+    member do
+      post :retry
+    end
+  end
+
+  resources :events, only: [:index]
 end

data/db/migrate/20260624000001_create_webhook_outbox_subscriptions.rb

@@ -1,6 +1,6 @@
 class CreateWebhookOutboxSubscriptions < ActiveRecord::Migration[7.2]
   def change
-    create_table :webhook_outbox_subscriptions do |t|
+    create_table :webhook_outbox_subscriptions, if_not_exists: true do |t|
       t.string :url, null: false
       t.string :secret, null: false
       t.json :events, null: false, default: []

data/db/migrate/20260624000002_create_webhook_outbox_deliveries.rb

@@ -1,6 +1,6 @@
 class CreateWebhookOutboxDeliveries < ActiveRecord::Migration[7.2]
   def change
-    create_table :webhook_outbox_deliveries do |t|
+    create_table :webhook_outbox_deliveries, if_not_exists: true do |t|
       t.references :subscription, null: false, foreign_key: { to_table: :webhook_outbox_subscriptions }
       t.string :event, null: false
       t.json :payload, null: false
@@ -13,8 +13,8 @@ class CreateWebhookOutboxDeliveries < ActiveRecord::Migration[7.2]
       t.timestamps
     end
 
-    add_index :webhook_outbox_deliveries, :status
-    add_index :webhook_outbox_deliveries, :event
-    add_index :webhook_outbox_deliveries, [:subscription_id, :created_at]
+    add_index :webhook_outbox_deliveries, :status, if_not_exists: true
+    add_index :webhook_outbox_deliveries, :event, if_not_exists: true
+    add_index :webhook_outbox_deliveries, [:subscription_id, :created_at], if_not_exists: true
   end
 end

data/db/migrate/20260629000002_add_idempotency_key_to_webhook_outbox_deliveries.rb

@@ -1,6 +1,6 @@
 class AddIdempotencyKeyToWebhookOutboxDeliveries < ActiveRecord::Migration[7.2]
   def change
-    add_column :webhook_outbox_deliveries, :idempotency_key, :string
-    add_index :webhook_outbox_deliveries, :idempotency_key, unique: true
+    add_column :webhook_outbox_deliveries, :idempotency_key, :string, if_not_exists: true
+    add_index :webhook_outbox_deliveries, :idempotency_key, unique: true, if_not_exists: true
   end
 end

data/db/migrate/20260701000001_add_secret_rotation_to_webhook_outbox_subscriptions.rb

@@ -0,0 +1,6 @@
+class AddSecretRotationToWebhookOutboxSubscriptions < ActiveRecord::Migration[7.2]
+  def change
+    add_column :webhook_outbox_subscriptions, :previous_secret, :string, if_not_exists: true
+    add_column :webhook_outbox_subscriptions, :previous_secret_expires_at, :datetime, if_not_exists: true
+  end
+end

data/db/migrate/20260701000002_add_consecutive_failures_to_webhook_outbox_subscriptions.rb

@@ -0,0 +1,5 @@
+class AddConsecutiveFailuresToWebhookOutboxSubscriptions < ActiveRecord::Migration[7.2]
+  def change
+    add_column :webhook_outbox_subscriptions, :consecutive_failures, :integer, null: false, default: 0, if_not_exists: true
+  end
+end

data/db/migrate/20261027000001_create_webhook_outbox_delivery_attempts.rb

@@ -0,0 +1,16 @@
+class CreateWebhookOutboxDeliveryAttempts < ActiveRecord::Migration[7.2]
+  def change
+    create_table :webhook_outbox_delivery_attempts, if_not_exists: true do |t|
+      t.references :delivery, null: false, index: false,
+        foreign_key: { to_table: :webhook_outbox_deliveries, on_delete: :cascade }
+      t.integer :attempt_number, null: false
+      t.integer :outcome, null: false
+      t.integer :response_code
+      t.text :response_body
+      t.integer :duration_ms
+      t.datetime :created_at, null: false
+    end
+
+    add_index :webhook_outbox_delivery_attempts, [:delivery_id, :attempt_number], if_not_exists: true
+  end
+end

data/lib/generators/rails_webhook_outbox/install/install_generator.rb

@@ -1,29 +1,11 @@
 require "rails/generators"
-require "rails/generators/active_record"
 
 module RailsWebhookOutbox
   module Generators
     class InstallGenerator < Rails::Generators::Base
-      include Rails::Generators::Migration
-
       source_root File.expand_path("templates", __dir__)
 
-      desc "Creates a RailsWebhookOutbox initializer and copies migrations to your application."
-
-      def self.next_migration_number(dirname)
-        ActiveRecord::Generators::Base.next_migration_number(dirname)
-      end
-
-      def copy_migrations
-        migration_template(
-          "create_webhook_outbox_subscriptions.rb.tt",
-          "db/migrate/create_webhook_outbox_subscriptions.rb"
-        )
-        migration_template(
-          "create_webhook_outbox_deliveries.rb.tt",
-          "db/migrate/create_webhook_outbox_deliveries.rb"
-        )
-      end
+      desc "Creates a RailsWebhookOutbox initializer. The engine supplies its own migrations; run `rails db:migrate` afterwards."
 
       def create_initializer
         template "initializer.rb", "config/initializers/rails_webhook_outbox.rb"

data/lib/rails_webhook_outbox/configuration.rb

@@ -5,7 +5,9 @@ module RailsWebhookOutbox
 
     attr_accessor :events, :signing_algorithm, :signing_header,
                   :max_retries, :retry_backoff, :request_timeout,
-                  :delivery_job_queue, :max_payload_size, :test_mode
+                  :delivery_job_queue, :max_payload_size, :test_mode,
+                  :secret_rotation_grace_period, :circuit_breaker_threshold,
+                  :dashboard_enabled
 
     def initialize
       @events = []
@@ -17,6 +19,9 @@ module RailsWebhookOutbox
       @delivery_job_queue = :webhooks
       @max_payload_size = 65_536
       @test_mode = false
+      @secret_rotation_grace_period = 24.hours
+      @circuit_breaker_threshold = 10
+      @dashboard_enabled = Rails.env.development?
     end
 
     def signing_algorithm=(value)
@@ -36,5 +41,13 @@ module RailsWebhookOutbox
 
       @retry_backoff = value
     end
+
+    def secret_rotation_grace_period=(value)
+      unless value.is_a?(Numeric) && value.positive?
+        raise ArgumentError, "secret_rotation_grace_period must be a positive duration"
+      end
+
+      @secret_rotation_grace_period = value
+    end
   end
 end

data/lib/rails_webhook_outbox/engine.rb

@@ -1,3 +1,6 @@
+require "turbo-rails"
+require "importmap-rails"
+
 module RailsWebhookOutbox
   class Engine < ::Rails::Engine
     isolate_namespace RailsWebhookOutbox
@@ -10,5 +13,18 @@ module RailsWebhookOutbox
         end
       end
     end
+
+    initializer "rails_webhook_outbox.assets" do |app|
+      if app.config.respond_to?(:assets)
+        app.config.assets.paths << RailsWebhookOutbox::Engine.root.join("app/javascript")
+      end
+    end
+
+    initializer "rails_webhook_outbox.importmap", before: "importmap" do |app|
+      if app.config.respond_to?(:importmap)
+        app.config.importmap.paths << RailsWebhookOutbox::Engine.root.join("config/importmap.rb")
+        app.config.importmap.cache_sweepers << RailsWebhookOutbox::Engine.root.join("app/javascript")
+      end
+    end
   end
 end

data/lib/rails_webhook_outbox/secret_rotation_error.rb

@@ -0,0 +1,8 @@
+module RailsWebhookOutbox
+  class SecretRotationError < StandardError
+    def initialize
+      super("Cannot rotate secret: the previous secret is still within its grace period. " \
+            "Pass force: true to rotate anyway and immediately invalidate it.")
+    end
+  end
+end

data/lib/rails_webhook_outbox/sender.rb

@@ -17,6 +17,7 @@ module RailsWebhookOutbox
       uri = URI.parse(@delivery.subscription.url)
       body = build_body
       request = build_request(uri, body)
+      Rails.logger.info { "[RailsWebhookOutbox] attempt event=#{@delivery.event} key=#{@delivery.idempotency_key} url=#{uri}" }
       response = execute(uri, request)
       raise DeliveryError.new(response) unless response.is_a?(Net::HTTPSuccess)
       response
@@ -35,7 +36,7 @@ module RailsWebhookOutbox
     def build_request(uri, body)
       req = Net::HTTP::Post.new(uri)
       req["Content-Type"] = "application/json"
-      req["X-Webhook-Signature"] = Signature.header_value(body, @delivery.subscription.secret)
+      req["X-Webhook-Signature"] = Signature.header_value(body, @delivery.subscription.signing_secrets)
       req["X-Webhook-Event"] = @delivery.event
       req["X-Webhook-Delivery"] = @delivery.idempotency_key
       req["X-Webhook-Timestamp"] = Time.now.utc.to_i.to_s

data/lib/rails_webhook_outbox/signature.rb

@@ -6,9 +6,9 @@ module RailsWebhookOutbox
       OpenSSL::HMAC.hexdigest(algorithm.to_s.upcase, secret, payload)
     end
 
-    def self.header_value(payload, secret)
+    def self.header_value(payload, secrets)
       algorithm = RailsWebhookOutbox.config.signing_algorithm
-      "#{algorithm}=#{sign(payload, secret, algorithm)}"
+      Array(secrets).map { |secret| "#{algorithm}=#{sign(payload, secret, algorithm)}" }.join(",")
     end
   end
 end

data/lib/rails_webhook_outbox/version.rb

@@ -1,3 +1,3 @@
 module RailsWebhookOutbox
-  VERSION = "0.2.0"
+  VERSION = "0.4.0"
 end

data/lib/rails_webhook_outbox.rb

@@ -3,6 +3,7 @@ require "rails_webhook_outbox/configuration"
 require "rails_webhook_outbox/signature"
 require "rails_webhook_outbox/delivery_error"
 require "rails_webhook_outbox/payload_size_error"
+require "rails_webhook_outbox/secret_rotation_error"
 require "rails_webhook_outbox/testing"
 require "rails_webhook_outbox/sender"
 require "rails_webhook_outbox/dispatchable"

data/lib/tasks/rails_webhook_outbox_tasks.rake

@@ -1,4 +1,51 @@
-# desc "Explaining what the task does"
-# task :rails_webhook_outbox do
-#   # Task goes here
-# end
+namespace :webhook_outbox do
+  desc "Re-enqueue failed deliveries for retry"
+  task retry_failed: :environment do
+    deliveries = RailsWebhookOutbox::Delivery.failed
+    count = deliveries.count
+
+    if count.zero?
+      puts "No failed deliveries to retry"
+    else
+      deliveries.find_each do |delivery|
+        delivery.update!(status: :pending, next_retry_at: nil)
+        RailsWebhookOutbox::DeliveryJob.perform_later(delivery)
+      end
+      puts "Re-enqueued #{count} failed #{"delivery".pluralize(count)} for retry"
+    end
+  end
+
+  desc "List all webhook subscriptions"
+  task list_subscriptions: :environment do
+    subscriptions = RailsWebhookOutbox::Subscription.order(:id)
+
+    if subscriptions.none?
+      puts "No subscriptions found"
+    else
+      subscriptions.find_each do |subscription|
+        puts format(
+          "#%d [%s] %s events=%s failures=%d",
+          subscription.id,
+          subscription.active? ? "active" : "inactive",
+          subscription.url,
+          subscription.events.join(","),
+          subscription.consecutive_failures
+        )
+      end
+    end
+  end
+
+  desc "Delete delivered and failed deliveries older than the given number of days"
+  task :cleanup, [:days] => :environment do |_task, args|
+    days = args[:days].to_i
+
+    if days <= 0
+      puts "Usage: rake webhook_outbox:cleanup[days] (days must be a positive integer)"
+    else
+      scope = RailsWebhookOutbox::Delivery.where(status: [:delivered, :failed]).where(created_at: ...days.days.ago)
+      count = scope.count
+      scope.delete_all
+      puts "Deleted #{count} #{"delivery".pluralize(count)} older than #{days} #{"day".pluralize(days)}"
+    end
+  end
+end