pgbus 0.7.2 → 0.7.4

data/config/locales/pt.yml

@@ -66,6 +66,12 @@ pt:
       index:
         discard_all: Descartar Tudo
         discard_all_confirm: Descartar permanentemente todas as mensagens DLQ?
+        discard_selected: Descartar Selecionados
+        discard_selected_confirm: Descartar mensagens DLQ selecionadas?
+        discarded_selected:
+          one: 1 mensagem DLQ descartada.
+          other: "%{count} mensagens DLQ descartadas."
+        none_selected: Nenhuma mensagem selecionada.
         retry_all: Tentar Novamente Tudo
         retry_all_confirm: Tentar novamente todas as mensagens DLQ?
         title: Fila de Mensagens Mortas
@@ -113,7 +119,34 @@ pt:
       delete_title: Excluir
       ok: OK
     events:
+      flash:
+        discard_failed: Não foi possível descartar o evento.
+        discarded: Evento descartado.
+        discarded_selected:
+          one: 1 evento descartado.
+          other: "%{count} eventos descartados."
+        mark_handled_failed: Não foi possível marcar o evento como tratado.
+        marked_handled: Evento marcado como tratado.
+        none_selected: Nenhum evento selecionado.
+        payload_update_failed: Não foi possível atualizar o payload. Verifique se o JSON é válido.
+        payload_updated: Payload atualizado e evento reenfileirado.
+        replay_failed: Evento não encontrado ou não pôde ser reproduzido.
+        replayed: Evento reproduzido.
+        reroute_failed: Não foi possível redirecionar o evento.
+        rerouted: Evento redirecionado para o manipulador alvo.
       index:
+        discard_all: Descartar Todos
+        discard_all_confirm: Descartar todos os eventos pendentes? Esta ação não pode ser desfeita.
+        discard_selected: Descartar Selecionados
+        discard_selected_confirm: Descartar eventos selecionados?
+        pending_empty: Nenhum evento pendente
+        pending_headers:
+          enqueued: Enfileirado
+          handler_queue: Fila do Manipulador
+          id: ID
+          reads: Leituras
+          routing_key: Chave de Roteamento
+        pending_title: Eventos Pendentes
         processed_empty: Nenhum evento processado ainda
         processed_headers:
           event_id: ID do evento
@@ -127,6 +160,26 @@ pt:
           queue: Fila
         subscribers_title: Assinantes registrados
         title: Eventos
+      pending_table:
+        arguments: Payload
+        discard: Descartar
+        discard_confirm: Descartar este evento? Ele será arquivado.
+        edit_payload: Editar e Tentar Novamente
+        edit_payload_confirm: Atualizar payload e reenfileirar este evento?
+        edit_payload_label: 'Payload JSON:'
+        event_id: 'ID do Evento:'
+        full_json_payload: Payload JSON Completo
+        headers_section: Cabeçalhos
+        mark_handled: Marcar como Tratado
+        mark_handled_confirm: Marcar este evento como tratado? Ele será arquivado e ignorado na reprodução.
+        metadata: Metadados
+        metadata_labels:
+          last_read: 'Última leitura:'
+          read_count: 'Contagem de leituras:'
+          visible_at: 'Visível em:'
+        reroute: Redirecionar
+        reroute_confirm: Redirecionar este evento para um manipulador diferente?
+        reroute_label: 'Manipulador alvo:'
       show:
         back: Voltar para eventos
         labels:
@@ -136,6 +189,9 @@ pt:
         not_found: Evento não encontrado
         title: Evento %{event_id}
     helpers:
+      bulk_select_all: Selecionar todos
+      bulk_select_row: Selecionar %{id}
+      bulk_selected: selecionado
       paused_badge: Pausado
       queue_badge:
         dlq: DLQ
@@ -150,11 +206,22 @@ pt:
       show:
         charts:
           failed_to_load: Falha ao carregar dados do gráfico
+          latency: Latência da Fila (ms)
+          latency_avg: Média
+          latency_p95: P95
           no_data: Sem dados ainda
           series_name: Tarefas/min
           status_distribution: Distribuição de status
           throughput: Taxa de transferência (tarefas/min)
         description_html: Métricas de desempenho de trabalho para os últimos %{range}
+        latency_by_queue:
+          empty: Ainda não há dados de latência
+          headers:
+            avg: Média (ms)
+            count: Contagem
+            p95: P95 (ms)
+            queue: Fila
+          title: Latência por Fila
         slowest:
           empty: Nenhuma estatística de tarefa ainda
           headers:
@@ -163,11 +230,32 @@ pt:
             job_class: Classe da tarefa
             max: Máximo
           title: Classes de Trabalho Mais Lentas (duração média)
+        streams:
+          summary:
+            active: Ativo
+            avg_fanout: Média de Ramificações
+            broadcasts: Transmissões
+            connects: Conexões
+            disconnects: Desconexões
+          title: Streams em Tempo Real
+          top:
+            empty: Nenhuma atividade de stream registrada na janela selecionada
+            headers:
+              avg_fanout: Média de Ramificações
+              avg_ms: Média de Despacho
+              broadcasts: Transmissões
+              stream: Stream
+            title: Principais Streams por Volume de Transmissão
         summary:
           avg_duration: Duração Média
+          avg_latency: Latência Média
+          avg_retries: Média de Tentativas
           dead_lettered: Cartas Mortas
           failed: Falhou
           max_duration: Duração Máxima
+          p50_latency: Latência P50
+          p95_latency: Latência P95
+          p99_latency: Latência P99
           succeeded: Bem-sucedido
           total_jobs: Total de Trabalhos
         time_ranges:
@@ -222,6 +310,12 @@ pt:
         discard_all: Descartar Todos
         discard_all_confirm: Descartar todos os trabalhos falhados?
         discard_all_enqueued_notice: Descartados %{count} trabalhos na fila e bloqueios liberados.
+        discard_selected: Descartar Selecionados
+        discard_selected_confirm: Descartar itens selecionados?
+        discarded_selected:
+          one: 1 item selecionado descartado.
+          other: "%{count} itens selecionados descartados."
+        none_selected: Nenhum item selecionado.
         retry_all: Tentar Novamente Todos
         retry_all_confirm: Tentar novamente todos os trabalhos falhados?
         title: Trabalhos
@@ -259,13 +353,28 @@ pt:
       toggle_menu: Alternar menu
     locks:
       index:
+        all_locks_discarded:
+          one: 1 bloqueio descartado.
+          other: "%{count} bloqueios descartados."
         description: Bloqueios de exclusividade ativos impedindo a execução duplicada do trabalho
+        discard: Descartar
+        discard_all: Descartar Todos
+        discard_all_confirm: Descartar permanentemente todos os bloqueios? Isso pode permitir a execução duplicada de trabalhos.
+        discard_confirm: Descartar este bloqueio? O trabalho associado pode ser enfileirado novamente.
+        discard_selected: Descartar Selecionados
+        discard_selected_confirm: Descartar bloqueios selecionados?
         empty: Nenhum bloqueio ativo
         headers:
           age: Idade
           lock_key: Chave de Bloqueio
           msg_id: ID da mensagem
           queue_name: Fila
+        lock_discard_failed: Não foi possível descartar o bloqueio.
+        lock_discarded: Bloqueio descartado.
+        locks_discarded:
+          one: 1 bloqueio descartado.
+          other: "%{count} bloqueios descartados."
+        none_selected: Nenhum bloqueio selecionado.
         title: Chaves de unicidade
     outbox:
       index:

data/config/locales/sv.yml

@@ -66,6 +66,12 @@ sv:
       index:
         discard_all: Kassera alla
         discard_all_confirm: Kassera permanent alla DLQ-meddelanden?
+        discard_selected: Kassera valda
+        discard_selected_confirm: Kassera valda DLQ-meddelanden?
+        discarded_selected:
+          one: Kasserade 1 DLQ-meddelande.
+          other: Kasserade %{count} DLQ-meddelanden.
+        none_selected: Inga meddelanden valda.
         retry_all: Försök igen alla
         retry_all_confirm: Försök igen alla DLQ-meddelanden?
         title: Dead Letter-kö
@@ -113,7 +119,34 @@ sv:
       delete_title: Ta bort
       ok: OK
     events:
+      flash:
+        discard_failed: Kunde inte kassera händelsen.
+        discarded: Händelse kasserad.
+        discarded_selected:
+          one: Kasserade 1 händelse.
+          other: Kasserade %{count} händelser.
+        mark_handled_failed: Kunde inte markera händelsen som hanterad.
+        marked_handled: Händelse markerad som hanterad.
+        none_selected: Inga händelser valda.
+        payload_update_failed: Kunde inte uppdatera payload. Kontrollera att JSON är giltig.
+        payload_updated: Payload uppdaterad och händelsen återköad.
+        replay_failed: Händelsen hittades inte eller kunde inte spelas upp.
+        replayed: Händelsen spelades upp.
+        reroute_failed: Kunde inte omdirigera händelsen.
+        rerouted: Händelsen omdirigerades till målhanteraren.
       index:
+        discard_all: Kassera alla
+        discard_all_confirm: Kassera alla väntande händelser? Detta kan inte ångras.
+        discard_selected: Kassera valda
+        discard_selected_confirm: Kassera valda händelser?
+        pending_empty: Inga väntande händelser
+        pending_headers:
+          enqueued: Köad
+          handler_queue: Handler-kö
+          id: ID
+          reads: Läsningar
+          routing_key: Routing-nyckel
+        pending_title: Väntande händelser
         processed_empty: Inga händelser behandlade än
         processed_headers:
           event_id: Händelse-ID
@@ -127,6 +160,26 @@ sv:
           queue: Kö
         subscribers_title: Registrerade prenumeranter
         title: Händelser
+      pending_table:
+        arguments: Payload
+        discard: Kassera
+        discard_confirm: Kassera denna händelse? Den kommer att arkiveras.
+        edit_payload: Redigera & Försök igen
+        edit_payload_confirm: Uppdatera payload och återköa denna händelse?
+        edit_payload_label: 'JSON Payload:'
+        event_id: 'Händelse-ID:'
+        full_json_payload: Fullständig JSON Payload
+        headers_section: Headers
+        mark_handled: Markera som hanterad
+        mark_handled_confirm: Markera denna händelse som hanterad? Den kommer att arkiveras och hoppas över vid uppspelning.
+        metadata: Metadata
+        metadata_labels:
+          last_read: 'Senast läst:'
+          read_count: 'Läsantal:'
+          visible_at: 'Synlig vid:'
+        reroute: Omdirigera
+        reroute_confirm: Omdirigera denna händelse till en annan hanterare?
+        reroute_label: 'Målhanterare:'
       show:
         back: Tillbaka till händelser
         labels:
@@ -136,6 +189,9 @@ sv:
         not_found: Händelse hittades inte
         title: Händelse %{event_id}
     helpers:
+      bulk_select_all: Markera alla
+      bulk_select_row: Markera %{id}
+      bulk_selected: valda
       paused_badge: Pausad
       queue_badge:
         dlq: DLQ
@@ -150,11 +206,22 @@ sv:
       show:
         charts:
           failed_to_load: Misslyckades att ladda diagramdata
+          latency: Köfördröjning (ms)
+          latency_avg: Genomsnitt
+          latency_p95: P95
           no_data: Inga data än
           series_name: Jobb/min
           status_distribution: Statusfördelning
           throughput: Genomströmning (jobb/min)
         description_html: Jobbprestandamått för de senaste %{range}
+        latency_by_queue:
+          empty: Ingen fördröjningsdata än
+          headers:
+            avg: Genomsnitt (ms)
+            count: Antal
+            p95: P95 (ms)
+            queue: Kö
+          title: Fördröjning per kö
         slowest:
           empty: Inga jobbstatistik än
           headers:
@@ -163,11 +230,32 @@ sv:
             job_class: Jobbklass
             max: Max
           title: Långsammaste jobbklasser (genomsnittlig varaktighet)
+        streams:
+          summary:
+            active: Aktiv
+            avg_fanout: Genomsnittlig spridning
+            broadcasts: Sändningar
+            connects: Anslutningar
+            disconnects: Frånkopplingar
+          title: Strömmar i realtid
+          top:
+            empty: Ingen strömaktivitet registrerad i det valda fönstret
+            headers:
+              avg_fanout: Genomsnittlig spridning
+              avg_ms: Genomsnittlig utsändning
+              broadcasts: Sändningar
+              stream: Ström
+            title: Toppströmmar efter sändningsvolym
         summary:
           avg_duration: Genomsnittlig varaktighet
+          avg_latency: Genomsnittlig fördröjning
+          avg_retries: Genomsnittliga omförsök
           dead_lettered: Dead Lettered
           failed: Misslyckades
           max_duration: Maximal varaktighet
+          p50_latency: P50-fördröjning
+          p95_latency: P95-fördröjning
+          p99_latency: P99-fördröjning
           succeeded: Lyckades
           total_jobs: Totalt antal jobb
         time_ranges:
@@ -222,6 +310,12 @@ sv:
         discard_all: Kassera alla
         discard_all_confirm: Kassera alla misslyckade jobb?
         discard_all_enqueued_notice: Kasserade %{count} köade jobb och frigjorde deras lås.
+        discard_selected: Kassera valda
+        discard_selected_confirm: Kassera valda objekt?
+        discarded_selected:
+          one: Kasserade 1 valt objekt.
+          other: Kasserade %{count} valda objekt.
+        none_selected: Inga objekt valda.
         retry_all: Försök igen alla
         retry_all_confirm: Försök igen alla misslyckade jobb?
         title: Jobb
@@ -259,13 +353,28 @@ sv:
       toggle_menu: Växla meny
     locks:
       index:
+        all_locks_discarded:
+          one: Kasserade 1 lås.
+          other: Kasserade %{count} lås.
         description: Aktiva unika lås som förhindrar duplicerad jobbexekvering
+        discard: Kassera
+        discard_all: Kassera alla
+        discard_all_confirm: Kassera alla lås permanent? Detta kan tillåta duplicerad jobbexekvering.
+        discard_confirm: Kassera detta lås? Det associerade jobbet kan köas igen.
+        discard_selected: Kassera valda
+        discard_selected_confirm: Kassera valda lås?
         empty: Inga aktiva lås
         headers:
           age: Ålder
           lock_key: Låsningsnyckel
           msg_id: Meddelande-ID
           queue_name: Kö
+        lock_discard_failed: Kunde inte kassera lås.
+        lock_discarded: Lås kasserat.
+        locks_discarded:
+          one: Kasserade 1 lås.
+          other: Kasserade %{count} lås.
+        none_selected: Inga lås valda.
         title: Unikhetsnycklar
     outbox:
       index:

data/config/routes.rb

@@ -50,6 +50,13 @@ Pgbus::Engine.routes.draw do
   resources :events, only: %i[index show] do
     member do
       post :replay
+      post :discard
+      post :mark_handled
+      post :edit_payload
+      post :reroute
+    end
+    collection do
+      post :discard_selected
     end
   end
 

data/lib/pgbus/configuration.rb

@@ -103,7 +103,7 @@ module Pgbus
                   :streams_default_retention, :streams_retention, :streams_heartbeat_interval,
                   :streams_max_connections, :streams_idle_timeout, :streams_listen_health_check_ms,
                   :streams_write_deadline_ms, :streams_falcon_streaming_body,
-                  :streams_stats_enabled
+                  :streams_stats_enabled, :streams_test_mode
 
     def initialize
       @database_url = nil
@@ -209,6 +209,7 @@ module Pgbus
       # gates pgbus_job_stats recording) on purpose — operators
       # usually want job stats on and stream stats off, or vice versa.
       @streams_stats_enabled = false
+      @streams_test_mode = false
     end
 
     def queue_name(name)

data/lib/pgbus/event_bus/publisher.rb

@@ -1,12 +1,35 @@
 # frozen_string_literal: true
 
+require "time"
+
 module Pgbus
   module EventBus
     module Publisher
       module_function
 
       def publish(routing_key, payload, headers: nil, delay: 0)
-        event_data = build_event_data(payload)
+        event_data = build_event_data(payload, routing_key: routing_key)
+
+        if defined?(Pgbus::Testing) && !Pgbus::Testing.disabled?
+          event = Pgbus::Event.new(
+            event_id: event_data["event_id"],
+            payload: event_data["payload"],
+            published_at: event_data["published_at"] ? Time.parse(event_data["published_at"]) : nil,
+            routing_key: routing_key,
+            headers: headers
+          )
+
+          Pgbus::Testing.store.push_event(event)
+
+          if Pgbus::Testing.inline? && delay.to_i <= 0
+            Pgbus::EventBus::Registry.instance.handlers_for(routing_key).each do |subscriber|
+              subscriber.handler_class.new.handle(event)
+            end
+          end
+
+          return event_data
+        end
+
         Pgbus.client.publish_to_topic(routing_key, event_data, headers: headers, delay: delay)
       end
 
@@ -14,7 +37,7 @@ module Pgbus
         publish(routing_key, payload, headers: headers, delay: delay)
       end
 
-      def build_event_data(payload)
+      def build_event_data(payload, routing_key: nil)
         event_id = SecureRandom.uuid
 
         serialized_payload = if payload.respond_to?(:to_global_id)
@@ -25,11 +48,13 @@ module Pgbus
                                { "value" => payload }
                              end
 
-        {
+        data = {
           "event_id" => event_id,
           "payload" => serialized_payload,
           "published_at" => Time.now.utc.iso8601(6)
         }
+        data["routing_key"] = routing_key if routing_key
+        data
       end
     end
   end

data/lib/pgbus/testing/assertions.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Pgbus
+  module Testing
+    # Framework-agnostic assertion helpers. Included by both RSpec and Minitest
+    # integrations. Can also be included directly in any test class.
+    #
+    #   include Pgbus::Testing::Assertions
+    #
+    #   assert_pgbus_published(count: 1, routing_key: "orders.created") do
+    #     Order.create!(...)
+    #   end
+    module Assertions
+      def pgbus_published_events(routing_key: nil)
+        Pgbus::Testing.store.events(routing_key: routing_key)
+      end
+
+      def assert_pgbus_published(count:, routing_key: nil)
+        before = pgbus_published_events(routing_key: routing_key).size
+        yield
+        after = pgbus_published_events(routing_key: routing_key).size
+        actual = after - before
+
+        return if actual == count
+
+        suffix = routing_key ? " matching #{routing_key.inspect}" : ""
+        raise_assertion("Expected #{count} event(s) published#{suffix}, got #{actual}")
+      end
+
+      def assert_no_pgbus_published(routing_key: nil)
+        before = pgbus_published_events(routing_key: routing_key).size
+        yield
+        after = pgbus_published_events(routing_key: routing_key).size
+        actual = after - before
+
+        return if actual.zero?
+
+        suffix = routing_key ? " matching #{routing_key.inspect}" : ""
+        raise_assertion("Expected no events published#{suffix}, got #{actual}")
+      end
+
+      # Execute the block, capturing events, then dispatch all captured events
+      # to their registered handlers.
+      def perform_published_events
+        yield
+        Pgbus::Testing.store.drain!
+      end
+
+      private
+
+      def raise_assertion(message)
+        # Use Minitest::Assertion if available, otherwise a generic RuntimeError
+        raise Minitest::Assertion, message if defined?(Minitest::Assertion)
+
+        raise message
+      end
+    end
+  end
+end

data/lib/pgbus/testing/minitest.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require_relative "../testing"
+
+module Pgbus
+  module Testing
+    # Minitest integration for Pgbus test helpers.
+    #
+    # Include in your test_helper.rb:
+    #
+    #   require "pgbus/testing/minitest"
+    #
+    #   class ActiveSupport::TestCase
+    #     include Pgbus::Testing::MinitestHelpers
+    #   end
+    #
+    # This provides:
+    #   - Automatic fake mode + store clearing per test
+    #   - assert_pgbus_published / assert_no_pgbus_published
+    #   - perform_published_events
+    #   - pgbus_published_events
+    module MinitestHelpers
+      include Pgbus::Testing::Assertions
+
+      def before_setup
+        Pgbus::Testing.fake!
+        Pgbus::Testing.store.clear!
+        super
+      end
+    end
+  end
+end

data/lib/pgbus/testing/rspec.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require_relative "../testing"
+
+RSpec::Matchers.define :have_published_event do |expected_routing_key|
+  supports_block_expectations
+
+  chain(:with_payload) { |payload| @expected_payload = payload }
+  chain(:with_headers) { |headers| @expected_headers = headers }
+  chain(:exactly)      { |count|   @expected_count = count }
+
+  match do |block|
+    @before = Pgbus::Testing.store.events(routing_key: expected_routing_key).dup
+    block.call
+    @after = Pgbus::Testing.store.events(routing_key: expected_routing_key)
+    @new_events = @after - @before
+
+    return false if @new_events.empty?
+
+    if @expected_payload
+      @new_events = @new_events.select { |e| values_match?(@expected_payload, e.payload) }
+      return false if @new_events.empty?
+    end
+
+    if @expected_headers
+      @new_events = @new_events.select { |e| values_match?(@expected_headers, e.headers) }
+      return false if @new_events.empty?
+    end
+
+    return false if @expected_count && @new_events.size != @expected_count
+
+    true
+  end
+
+  match_when_negated do |block|
+    @before = Pgbus::Testing.store.events(routing_key: expected_routing_key).dup
+    block.call
+    @after = Pgbus::Testing.store.events(routing_key: expected_routing_key)
+    @new_events = @after - @before
+
+    @new_events = @new_events.select { |e| values_match?(@expected_payload, e.payload) } if @expected_payload
+
+    @new_events = @new_events.select { |e| values_match?(@expected_headers, e.headers) } if @expected_headers
+
+    if @expected_count
+      @new_events.size != @expected_count
+    else
+      @new_events.empty?
+    end
+  end
+
+  failure_message do
+    parts = ["expected block to publish a #{expected_routing_key.inspect} event"]
+    parts << "with payload #{@expected_payload.inspect}" if @expected_payload
+    parts << "with headers #{@expected_headers.inspect}" if @expected_headers
+    parts << "exactly #{@expected_count} time(s)" if @expected_count
+
+    published = @new_events&.size || 0
+    parts << "but #{published} matching event(s) were published"
+
+    if published.positive? && @expected_payload
+      actual_payloads = @after.map(&:payload)
+      parts << "actual payloads: #{actual_payloads.inspect}"
+    end
+
+    parts.join(", ")
+  end
+
+  failure_message_when_negated do
+    "expected block not to publish a #{expected_routing_key.inspect} event, but #{@new_events.size} were published"
+  end
+end
+
+RSpec.configure do |config|
+  config.include Pgbus::Testing::Assertions
+end