jetstream_bridge 2.9.0 → 2.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0fd7228628d4d5308efceec8d1bf60d9dcff0caf311ab6d459c6c9fc32fbea11
-  data.tar.gz: 4fe44a58012328837b727807d5d07aa3f265ff8c23dc852a906d84714eaebbf8
+  metadata.gz: 15fe547a615edbbd3bbeafb5bf5193bfdc4f1bd9911d7497803cf5d331ced36b
+  data.tar.gz: 5c0b98f2cbbff19762e98abcb39fa7c5f006cbfcd951295020adbcc08da80d49
 SHA512:
-  metadata.gz: d9343bc42829b93c1279e4bd2a22fafdd77f69a1e18330b9771f37caeb04fac83fab7687b099484e670a8027d139ee5354601485a06d83ac79b1e3bd265b3a29
-  data.tar.gz: aab3b5ae4b601ece51560a46fca18f459f01de29b3731fd545ad08e1a00607e54b03167b484a5aa59e414be448c877d8f909c17640fa00ab2c4301618953c2fe
+  metadata.gz: 4135f2c9287c5ddc0716f9eb7f3bcfeab104072c0ed59bdf41ff7a3df07dd5254240147e6a176d80f3a93198240ee633ff24ed742caf6142c859d6f259110c56
+  data.tar.gz: d341432852e94c1983128f5d0b0094e812c867f7133c609f609fb4606a4945ee2e5129cc20a24ef166e9e36dbd73a06e6bcb3b3a6d8c19752906a26756883345

data/lib/generators/jetstream_bridge/initializer/templates/jetstream_bridge.rb

@@ -6,7 +6,7 @@ JetstreamBridge.configure do |config|
   config.nats_urls       = ENV.fetch('NATS_URLS', 'nats://localhost:4222')
   config.env             = ENV.fetch('NATS_ENV',  Rails.env)
   config.app_name        = ENV.fetch('APP_NAME',  Rails.application.class.module_parent_name.underscore)
-  config.destination_app = ENV['DESTINATION_APP'] # required for cross-app data sync
+  config.destination_app = ENV.fetch('DESTINATION_APP', nil) # required for cross-app data sync
 
   # Consumer Tuning
   config.max_deliver = 5
@@ -21,4 +21,7 @@ JetstreamBridge.configure do |config|
   # Models (override if you keep custom AR classes)
   config.outbox_model = 'JetstreamBridge::OutboxEvent'
   config.inbox_model  = 'JetstreamBridge::InboxEvent'
+
+  # Logging
+  # config.logger = Rails.logger
 end

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

@@ -8,11 +8,13 @@ module JetstreamBridge
     class InstallGenerator < Rails::Generators::Base
       desc 'Creates JetstreamBridge initializer and migrations'
       def create_initializer
-        Rails::Generators.invoke('jetstream_bridge:initializer', [], behavior: behavior, destination_root: destination_root)
+        Rails::Generators.invoke('jetstream_bridge:initializer', [], behavior: behavior,
+                                                                     destination_root: destination_root)
       end
 
       def create_migrations
-        Rails::Generators.invoke('jetstream_bridge:migrations', [], behavior: behavior, destination_root: destination_root)
+        Rails::Generators.invoke('jetstream_bridge:migrations', [], behavior: behavior,
+                                                                    destination_root: destination_root)
       end
     end
   end

data/lib/generators/jetstream_bridge/migrations/migrations_generator.rb

@@ -8,6 +8,7 @@ module JetstreamBridge
     # Migrations generator.
     class MigrationsGenerator < Rails::Generators::Base
       include Rails::Generators::Migration
+
       source_root File.expand_path('templates', __dir__)
       desc 'Creates Inbox/Outbox migrations for JetstreamBridge'
 

data/lib/jetstream_bridge/consumer/consumer.rb

@@ -7,7 +7,6 @@ require_relative '../core/duration'
 require_relative '../core/logging'
 require_relative '../core/config'
 require_relative '../core/model_utils'
-require_relative 'consumer_config'
 require_relative 'message_processor'
 require_relative 'subscription_manager'
 require_relative 'inbox/inbox_processor'
@@ -20,13 +19,12 @@ module JetstreamBridge
     IDLE_SLEEP_SECS       = 0.05
     MAX_IDLE_BACKOFF_SECS = 1.0
 
-    def initialize(durable_name: JetstreamBridge.config.durable_name,
-                   batch_size: DEFAULT_BATCH_SIZE, &block)
+    def initialize(durable_name: nil, batch_size: nil, &block)
       raise ArgumentError, 'handler block required' unless block_given?
 
       @handler       = block
-      @batch_size    = Integer(batch_size)
-      @durable       = durable_name
+      @batch_size    = Integer(batch_size || DEFAULT_BATCH_SIZE)
+      @durable       = durable_name || JetstreamBridge.config.durable_name
       @idle_backoff  = IDLE_SLEEP_SECS
       @running       = true
       @jts           = Connection.connect!
@@ -103,15 +101,15 @@ module JetstreamBridge
       0
     end
 
-    def handle_js_error(e)
-      if recoverable_consumer_error?(e)
+    def handle_js_error(error)
+      if recoverable_consumer_error?(error)
         Logging.warn(
-          "Recovering subscription after error: #{e.class} #{e.message}",
+          "Recovering subscription after error: #{error.class} #{error.message}",
           tag: 'JetstreamBridge::Consumer'
         )
         ensure_subscription!
       else
-        Logging.error("Fetch failed (non-recoverable): #{e.class} #{e.message}", tag: 'JetstreamBridge::Consumer')
+        Logging.error("Fetch failed (non-recoverable): #{error.class} #{error.message}", tag: 'JetstreamBridge::Consumer')
       end
       0
     end

data/lib/jetstream_bridge/consumer/inbox/inbox_message.rb

@@ -7,6 +7,7 @@ module JetstreamBridge
   class InboxMessage
     attr_reader :msg, :seq, :deliveries, :stream, :subject, :headers, :body, :raw, :event_id, :now
 
+    # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
     def self.from_nats(msg)
       meta       = (msg.respond_to?(:metadata) && msg.metadata) || nil
       seq        = meta.respond_to?(:stream_sequence) ? meta.stream_sequence : nil
@@ -30,7 +31,9 @@ module JetstreamBridge
 
       new(msg, seq, deliveries, stream, subject, headers, body, raw, id, Time.now.utc, consumer)
     end
+    # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
 
+    # rubocop:disable Metrics/ParameterLists
     def initialize(msg, seq, deliveries, stream, subject, headers, body, raw, event_id, now, consumer = nil)
       @msg        = msg
       @seq        = seq
@@ -44,6 +47,7 @@ module JetstreamBridge
       @now        = now
       @consumer   = consumer
     end
+    # rubocop:enable Metrics/ParameterLists
 
     def body_for_store
       body.empty? ? raw : body
@@ -59,7 +63,7 @@ module JetstreamBridge
 
     def metadata
       @metadata ||= Struct.new(:num_delivered, :sequence, :consumer, :stream)
-                           .new(deliveries, seq, @consumer, stream)
+                          .new(deliveries, seq, @consumer, stream)
     end
 
     def ack(*args, **kwargs)

data/lib/jetstream_bridge/consumer/inbox/inbox_repository.rb

@@ -25,53 +25,31 @@ module JetstreamBridge
     end
 
     def persist_pre(record, msg)
-      ModelUtils.assign_known_attrs(record, {
-                                      event_id: (if ModelUtils.has_columns?(@klass,
-                                                                            :event_id)
-                                                   msg.event_id
-                                                 end),
-                                      subject: msg.subject,
-                                      payload: ModelUtils.json_dump(msg.body_for_store),
-                                      headers: ModelUtils.json_dump(msg.headers),
-                                      stream: (if ModelUtils.has_columns?(@klass,
-                                                                          :stream)
-                                                 msg.stream
-                                               end),
-                                      stream_seq: (if ModelUtils.has_columns?(@klass,
-                                                                              :stream_seq)
-                                                     msg.seq
-                                                   end),
-                                      deliveries: (if ModelUtils.has_columns?(@klass,
-                                                                              :deliveries)
-                                                     msg.deliveries
-                                                   end),
-                                      status: 'processing',
-                                      last_error: nil,
-                                      received_at: (if ModelUtils.has_columns?(@klass,
-                                                                               :received_at)
-                                                      record.received_at || msg.now
-                                                    end),
-                                      updated_at: (if ModelUtils.has_columns?(@klass,
-                                                                              :updated_at)
-                                                     msg.now
-                                                   end)
-                                    })
+      attrs = {
+        event_id: msg.event_id,
+        subject: msg.subject,
+        payload: ModelUtils.json_dump(msg.body_for_store),
+        headers: ModelUtils.json_dump(msg.headers),
+        stream: msg.stream,
+        stream_seq: msg.seq,
+        deliveries: msg.deliveries,
+        status: 'processing',
+        last_error: nil,
+        received_at: record.respond_to?(:received_at) ? (record.received_at || msg.now) : nil,
+        updated_at: record.respond_to?(:updated_at) ? msg.now : nil
+      }
+      ModelUtils.assign_known_attrs(record, attrs)
       record.save!
     end
 
     def persist_post(record)
       now = Time.now.utc
-      ModelUtils.assign_known_attrs(record, {
-                                      status: 'processed',
-                                      processed_at: (if ModelUtils.has_columns?(@klass,
-                                                                                :processed_at)
-                                                       now
-                                                     end),
-                                      updated_at: (if ModelUtils.has_columns?(@klass,
-                                                                              :updated_at)
-                                                     now
-                                                   end)
-                                    })
+      attrs = {
+        status: 'processed',
+        processed_at: record.respond_to?(:processed_at) ? now : nil,
+        updated_at: record.respond_to?(:updated_at) ? now : nil
+      }
+      ModelUtils.assign_known_attrs(record, attrs)
       record.save!
     end
 
@@ -79,20 +57,12 @@ module JetstreamBridge
       return unless record
 
       now = Time.now.utc
-      ModelUtils.assign_known_attrs(record, {
-                                      status: (if ModelUtils.has_columns?(@klass,
-                                                                          :status)
-                                                 'failed'
-                                               end),
-                                      last_error: (if ModelUtils.has_columns?(@klass,
-                                                                              :last_error)
-                                                     "#{error.class}: #{error.message}"
-                                                   end),
-                                      updated_at: (if ModelUtils.has_columns?(@klass,
-                                                                              :updated_at)
-                                                     now
-                                                   end)
-                                    })
+      attrs = {
+        status: 'failed',
+        last_error: "#{error.class}: #{error.message}",
+        updated_at: record.respond_to?(:updated_at) ? now : nil
+      }
+      ModelUtils.assign_known_attrs(record, attrs)
       record.save!
     rescue StandardError => e
       Logging.warn("Failed to persist inbox failure: #{e.class}: #{e.message}",

data/lib/jetstream_bridge/consumer/message_processor.rb

@@ -1,12 +1,50 @@
 # frozen_string_literal: true
 
 require 'oj'
+require 'securerandom'
 require_relative '../core/logging'
-require_relative 'message_context'
 require_relative 'dlq_publisher'
-require_relative 'backoff_strategy'
 
 module JetstreamBridge
+  # Immutable per-message metadata.
+  MessageContext = Struct.new(
+    :event_id, :deliveries, :subject, :seq, :consumer, :stream,
+    keyword_init: true
+  ) do
+    def self.build(msg)
+      new(
+        event_id: msg.header&.[]('nats-msg-id') || SecureRandom.uuid,
+        deliveries: msg.metadata&.num_delivered.to_i,
+        subject: msg.subject,
+        seq: msg.metadata&.sequence,
+        consumer: msg.metadata&.consumer,
+        stream: msg.metadata&.stream
+      )
+    end
+  end
+
+  # Simple exponential backoff strategy for transient failures.
+  class BackoffStrategy
+    TRANSIENT_ERRORS = [Timeout::Error, IOError].freeze
+    MAX_EXPONENT     = 6
+    MAX_DELAY        = 60
+    MIN_DELAY        = 1
+
+    # Returns a bounded delay in seconds
+    def delay(deliveries, error)
+      base = transient?(error) ? 0.5 : 2.0
+      power = [deliveries - 1, MAX_EXPONENT].min
+      raw = (base * (2**power)).to_i
+      raw.clamp(MIN_DELAY, MAX_DELAY)
+    end
+
+    private
+
+    def transient?(error)
+      TRANSIENT_ERRORS.any? { |k| error.is_a?(k) }
+    end
+  end
+
   # Orchestrates parse → handler → ack/nak → DLQ
   class MessageProcessor
     UNRECOVERABLE_ERRORS = [ArgumentError, TypeError].freeze

data/lib/jetstream_bridge/consumer/subscription_manager.rb

@@ -2,7 +2,6 @@
 
 require_relative '../core/logging'
 require_relative '../core/duration'
-require_relative '../consumer/consumer_config'
 
 module JetstreamBridge
   # Encapsulates durable ensure + subscribe for a pull consumer.
@@ -11,7 +10,7 @@ module JetstreamBridge
       @jts     = jts
       @durable = durable
       @cfg     = cfg
-      @desired_cfg      = ConsumerConfig.consumer_config(@durable, filter_subject)
+      @desired_cfg      = build_consumer_config(@durable, filter_subject)
       @desired_cfg_norm = normalize_consumer_config(@desired_cfg)
     end
 
@@ -74,6 +73,18 @@ module JetstreamBridge
       )
     end
 
+    def build_consumer_config(durable, filter_subject)
+      {
+        durable_name: durable,
+        filter_subject: filter_subject,
+        ack_policy: 'explicit',
+        deliver_policy: 'all',
+        max_deliver: JetstreamBridge.config.max_deliver,
+        ack_wait: Duration.to_millis(JetstreamBridge.config.ack_wait),
+        backoff: Array(JetstreamBridge.config.backoff).map { |d| Duration.to_millis(d) }
+      }
+    end
+
     # Normalize both server-returned config objects and our desired hash
     # into a common hash with consistent units/types for accurate comparison.
     def normalize_consumer_config(cfg)

data/lib/jetstream_bridge/core/config.rb

@@ -5,7 +5,7 @@ module JetstreamBridge
     attr_accessor :destination_app, :nats_urls, :env, :app_name,
                   :max_deliver, :ack_wait, :backoff,
                   :use_outbox, :use_inbox, :inbox_model, :outbox_model,
-                  :use_dlq
+                  :use_dlq, :logger
 
     def initialize
       @nats_urls       = ENV['NATS_URLS'] || ENV['NATS_URL'] || 'nats://localhost:4222'
@@ -22,6 +22,7 @@ module JetstreamBridge
       @use_dlq      = true
       @outbox_model = 'JetstreamBridge::OutboxEvent'
       @inbox_model  = 'JetstreamBridge::InboxEvent'
+      @logger       = nil
     end
 
     # Single stream name per env

data/lib/jetstream_bridge/core/logging.rb

@@ -1,20 +1,31 @@
 # frozen_string_literal: true
 
 require 'uri'
+require 'logger'
 
 module JetstreamBridge
-  # Logging helpers that route to Rails.logger when available,
-  # falling back to STDOUT.
+  # Logging helpers that route to the configured logger when available,
+  # falling back to Rails.logger or STDOUT.
   module Logging
     module_function
 
+    def logger
+      JetstreamBridge.config.logger ||
+        (defined?(Rails) && Rails.respond_to?(:logger) && Rails.logger) ||
+        default_logger
+    end
+
+    def default_logger
+      @default_logger ||= Logger.new($stdout)
+    end
+
     def log(level, msg, tag: nil)
       message = tag ? "[#{tag}] #{msg}" : msg
-      if defined?(Rails) && Rails.respond_to?(:logger) && Rails.logger
-        Rails.logger.public_send(level, message)
-      else
-        puts "[#{level.to_s.upcase}] #{message}"
-      end
+      logger.public_send(level, message)
+    end
+
+    def debug(msg, tag: nil)
+      log(:debug, msg, tag: tag)
     end
 
     def info(msg, tag: nil)
@@ -29,6 +40,7 @@ module JetstreamBridge
       log(:error, msg, tag: tag)
     end
 
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
     def sanitize_url(url)
       uri = URI.parse(url)
       return url unless uri.user || uri.password
@@ -55,5 +67,6 @@ module JetstreamBridge
         "#{scheme}://#{masked}@"
       end
     end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
   end
 end

data/lib/jetstream_bridge/core/model_utils.rb

@@ -14,10 +14,13 @@ module JetstreamBridge
       defined?(ActiveRecord::Base) && klass <= ActiveRecord::Base
     end
 
+    # rubocop:disable Naming/PredicatePrefix
     def has_columns?(klass, *cols)
       return false unless ar_class?(klass)
+
       cols.flatten.all? { |c| klass.column_names.include?(c.to_s) }
     end
+    # rubocop:enable Naming/PredicatePrefix
 
     def assign_known_attrs(record, attrs)
       attrs.each do |k, v|
@@ -30,9 +33,7 @@ module JetstreamBridge
     def find_or_init_by_best(klass, *keysets)
       keysets.each do |keys|
         next if keys.nil? || keys.empty?
-        if has_columns?(klass, keys.keys)
-          return klass.find_or_initialize_by(keys)
-        end
+        return klass.find_or_initialize_by(keys) if has_columns?(klass, keys.keys)
       end
       klass.new
     end

data/lib/jetstream_bridge/inbox_event.rb

@@ -15,6 +15,7 @@ module JetstreamBridge
 
       class << self
         # Safe column presence check that never boots a connection during class load.
+        # rubocop:disable Naming/PredicatePrefix
         def has_column?(name)
           return false unless ar_connected?
 
@@ -22,6 +23,7 @@ module JetstreamBridge
         rescue ActiveRecord::ConnectionNotEstablished, ActiveRecord::NoDatabaseError
           false
         end
+        # rubocop:enable Naming/PredicatePrefix
 
         def ar_connected?
           ActiveRecord::Base.connected? && connection_pool.active_connection?
@@ -66,9 +68,7 @@ module JetstreamBridge
       # ---- Defaults that do not require schema at load time ----
       before_validation do
         self.status ||= 'received' if self.class.has_column?(:status) && status.blank?
-        if self.class.has_column?(:received_at) && received_at.blank?
-          self.received_at ||= Time.now.utc
-        end
+        self.received_at ||= Time.now.utc if self.class.has_column?(:received_at) && received_at.blank?
       end
 
       # ---- Helpers ----
@@ -103,7 +103,7 @@ module JetstreamBridge
           raise_missing_ar!('Inbox', method_name)
         end
 
-        def respond_to_missing?(_m, _p = false)
+        def respond_to_missing?(_method_name, _include_private = false)
           false
         end
 

data/lib/jetstream_bridge/outbox_event.rb

@@ -15,6 +15,7 @@ module JetstreamBridge
 
       class << self
         # Safe column presence check that never boots a connection during class load.
+        # rubocop:disable Naming/PredicatePrefix
         def has_column?(name)
           return false unless ar_connected?
 
@@ -22,6 +23,7 @@ module JetstreamBridge
         rescue ActiveRecord::ConnectionNotEstablished, ActiveRecord::NoDatabaseError
           false
         end
+        # rubocop:enable Naming/PredicatePrefix
 
         def ar_connected?
           # Avoid creating a connection; rescue if pool isn't set yet.
@@ -111,7 +113,7 @@ module JetstreamBridge
           raise_missing_ar!('Outbox', method_name)
         end
 
-        def respond_to_missing?(_m, _p = false)
+        def respond_to_missing?(_method_name, _include_private = false)
           false
         end
 

data/lib/jetstream_bridge/topology/stream.rb

@@ -123,9 +123,7 @@ module JetstreamBridge
 
         # Retention is immutable; warn if different and do not include on update.
         have_ret = info.config.retention.to_s.downcase
-        if have_ret != RETENTION
-          StreamSupport.log_retention_mismatch(name, have: have_ret, want: RETENTION)
-        end
+        StreamSupport.log_retention_mismatch(name, have: have_ret, want: RETENTION) if have_ret != RETENTION
 
         # Storage can be updated; do it without passing retention.
         have_storage = info.config.storage.to_s.downcase

data/lib/jetstream_bridge/topology/subject_matcher.rb

@@ -48,20 +48,30 @@ module JetstreamBridge
       while ai < a_parts.length && bi < b_parts.length
         at = a_parts[ai]
         bt = b_parts[bi]
-        return true if at == '>' || bt == '>'
-        return false unless at == bt || at == '*' || bt == '*'
+        return true if tail?(at, bt)
+        return false unless token_match?(at, bt)
 
         ai += 1
         bi += 1
       end
 
-      # If any side still has a '>' remaining, it can absorb the other's remainder
-      a_tail = a_parts[ai..] || []
-      b_tail = b_parts[bi..] || []
+      tail_overlap?(a_parts[ai..], b_parts[bi..])
+    end
+
+    def tail?(a_token, b_token)
+      a_token == '>' || b_token == '>'
+    end
+
+    def token_match?(a_token, b_token)
+      a_token == b_token || a_token == '*' || b_token == '*'
+    end
+
+    def tail_overlap?(a_tail, b_tail)
+      a_tail ||= []
+      b_tail ||= []
       return true if a_tail.include?('>') || b_tail.include?('>')
 
-      # Otherwise they overlap only if both consumed exactly
-      ai == a_parts.length && bi == b_parts.length
+      a_tail.empty? && b_tail.empty?
     end
   end
 end

data/lib/jetstream_bridge/topology/topology.rb

@@ -14,7 +14,7 @@ module JetstreamBridge
 
       Logging.info(
         "Subjects ready: producer=#{cfg.source_subject}, consumer=#{cfg.destination_subject}. " \
-          "Counterpart publishes on #{cfg.destination_subject} and subscribes on #{cfg.source_subject}.",
+        "Counterpart publishes on #{cfg.destination_subject} and subscribes on #{cfg.source_subject}.",
         tag: 'JetstreamBridge::Topology'
       )
     end

data/lib/jetstream_bridge/version.rb

@@ -4,5 +4,5 @@
 #
 # Version constant for the gem.
 module JetstreamBridge
-  VERSION = '2.9.0'
+  VERSION = '2.10.0'
 end

data/lib/jetstream_bridge.rb

@@ -15,7 +15,6 @@ require_relative 'jetstream_bridge/railtie' if defined?(Rails::Railtie)
 require_relative 'jetstream_bridge/inbox_event'
 require_relative 'jetstream_bridge/outbox_event'
 
-
 # JetstreamBridge main module.
 module JetstreamBridge
   class << self
@@ -54,13 +53,6 @@ module JetstreamBridge
       Connection.jetstream
     end
 
-    # @deprecated Use {ensure_topology!} instead. This method will be removed
-    #   in a future version.
-    def ensure_topology?
-      Logging.warn('ensure_topology? is deprecated; use ensure_topology! instead', tag: 'JetstreamBridge')
-      !!ensure_topology!
-    end
-
     private
 
     def assign!(cfg, key, val)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jetstream_bridge
 version: !ruby/object:Gem::Version
-  version: 2.9.0
+  version: 2.10.0
 platform: ruby
 authors:
 - Mike Attara
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-25 00:00:00.000000000 Z
+date: 2025-08-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -83,14 +83,11 @@ files:
 - lib/generators/jetstream_bridge/migrations/templates/create_jetstream_inbox_events.rb.erb
 - lib/generators/jetstream_bridge/migrations/templates/create_jetstream_outbox_events.rb.erb
 - lib/jetstream_bridge.rb
-- lib/jetstream_bridge/consumer/backoff_strategy.rb
 - lib/jetstream_bridge/consumer/consumer.rb
-- lib/jetstream_bridge/consumer/consumer_config.rb
 - lib/jetstream_bridge/consumer/dlq_publisher.rb
 - lib/jetstream_bridge/consumer/inbox/inbox_message.rb
 - lib/jetstream_bridge/consumer/inbox/inbox_processor.rb
 - lib/jetstream_bridge/consumer/inbox/inbox_repository.rb
-- lib/jetstream_bridge/consumer/message_context.rb
 - lib/jetstream_bridge/consumer/message_processor.rb
 - lib/jetstream_bridge/consumer/subscription_manager.rb
 - lib/jetstream_bridge/core/config.rb

data/lib/jetstream_bridge/consumer/backoff_strategy.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-module JetstreamBridge
-  class BackoffStrategy
-    TRANSIENT_ERRORS = [Timeout::Error, IOError].freeze
-    MAX_EXPONENT     = 6
-    MAX_DELAY        = 60
-    MIN_DELAY        = 1
-
-    # Returns a bounded delay in seconds
-    def delay(deliveries, error)
-      base = transient?(error) ? 0.5 : 2.0
-      power = [deliveries - 1, MAX_EXPONENT].min
-      raw = (base * (2**power)).to_i
-      raw.clamp(MIN_DELAY, MAX_DELAY)
-    end
-
-    private
-
-    def transient?(error)
-      TRANSIENT_ERRORS.any? { |k| error.is_a?(k) }
-    end
-  end
-end

data/lib/jetstream_bridge/consumer/consumer_config.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../core/duration'
-require_relative '../core/config'
-require_relative '../core/logging'
-
-module JetstreamBridge
-  # Consumer configuration helpers.
-  module ConsumerConfig
-    module_function
-
-    # Complete consumer config (pre-provisioned durable, pull mode).
-    def consumer_config(durable, filter_subject)
-      {
-        durable_name: durable,
-        filter_subject: filter_subject,
-        ack_policy: 'explicit',
-        deliver_policy: 'all',
-        max_deliver: JetstreamBridge.config.max_deliver,
-        ack_wait: Duration.to_millis(JetstreamBridge.config.ack_wait),
-        backoff: Array(JetstreamBridge.config.backoff)
-          .map { |d| Duration.to_millis(d) }
-      }
-    end
-  end
-end

data/lib/jetstream_bridge/consumer/message_context.rb

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-require 'securerandom'
-
-module JetstreamBridge
-  # Immutable per-message metadata
-  MessageContext = Struct.new(
-    :event_id, :deliveries, :subject, :seq, :consumer, :stream,
-    keyword_init: true
-  ) do
-    def self.build(msg)
-      new(
-        event_id: msg.header&.[]('nats-msg-id') || SecureRandom.uuid,
-        deliveries: msg.metadata&.num_delivered.to_i,
-        subject: msg.subject,
-        seq: msg.metadata&.sequence,
-        consumer: msg.metadata&.consumer,
-        stream: msg.metadata&.stream
-      )
-    end
-  end
-end