jetstream_bridge 2.6.0 → 2.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c35f196b9196a72202963a0cd3bd6c69cac3f69b24ffa088acec1da028626b08
-  data.tar.gz: cc6fd1ee6669d29bfb25f9ce0c88102df0e19a764b0402ff7cc2314bdec93fdb
+  metadata.gz: eeebee439d30bce4eac88df3c7cbc09c2e0af258a071bbd053c0fd10f244c995
+  data.tar.gz: de810b9580efcc26b8cb44810994f64e7ae68548c2bf59b01f8a676db8e6d131
 SHA512:
-  metadata.gz: fb054b30229005b00cbe3d39c1a798fdf6fe90cce7b8e440105528fa4b3415ecec78058daeaa3c38e43894cca57ccae0b12dff037cbbda260da5959253873ca9
-  data.tar.gz: fd3ed465ab7601c221ba861032467bcef304bf17b0e45335df92c5f862900dfc03592ba95c0bc30ae32ff03b81484f6975709d609d317a9d1e81154bbd8df17a
+  metadata.gz: 0c28944d07ee1399425fb194f4fe58e2ae6006c34f722091f2b88fb959f1012b83008c26d397385eff1d61a2a5df54f85975208ec882bb63f28ef51f77d90f02
+  data.tar.gz: 7fdefcc529051eadcccc4d536adc71b7da61c3928adf17ccc7c76c73d9b9c7735bd30626e3a779264a40cd2d5e36044de08075124c16b68bcff01ae302c276c8

data/lib/jetstream_bridge/consumer/consumer.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require 'json'
+require 'oj'
 require 'securerandom'
 require_relative '../core/connection'
 require_relative '../core/duration'
@@ -15,35 +15,47 @@ require_relative 'inbox/inbox_processor'
 module JetstreamBridge
   # Subscribes to destination subject and processes messages via a pull durable.
   class Consumer
-    DEFAULT_BATCH_SIZE = 25
-    FETCH_TIMEOUT_SECS = 5
-    IDLE_SLEEP_SECS    = 0.05
+    DEFAULT_BATCH_SIZE    = 25
+    FETCH_TIMEOUT_SECS    = 5
+    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)
-      @handler    = block
-      @batch_size = batch_size
-      @durable    = durable_name
-      @jts        = Connection.connect!
+      raise ArgumentError, 'handler block required' unless block_given?
+
+      @handler       = block
+      @batch_size    = Integer(batch_size)
+      @durable       = durable_name
+      @idle_backoff  = IDLE_SLEEP_SECS
+      @running       = true
+      @jts           = Connection.connect!
 
       ensure_destination!
 
       @sub_mgr = SubscriptionManager.new(@jts, @durable, JetstreamBridge.config)
-      @sub_mgr.ensure_consumer!
-      @psub = @sub_mgr.subscribe!
-
       @processor  = MessageProcessor.new(@jts, @handler)
       @inbox_proc = InboxProcessor.new(@processor) if JetstreamBridge.config.use_inbox
+
+      ensure_subscription!
     end
 
     def run!
-      Logging.info("Consumer #{@durable} started…", tag: 'JetstreamBridge::Consumer')
-      loop do
+      Logging.info(
+        "Consumer #{@durable} started (batch=#{@batch_size}, dest=#{JetstreamBridge.config.destination_subject})…",
+        tag: 'JetstreamBridge::Consumer'
+      )
+      while @running
         processed = process_batch
-        sleep(IDLE_SLEEP_SECS) if processed.zero?
+        idle_sleep(processed)
       end
     end
 
+    # Allow external callers to stop a long-running loop gracefully.
+    def stop!
+      @running = false
+    end
+
     private
 
     def ensure_destination!
@@ -52,14 +64,24 @@ module JetstreamBridge
       raise ArgumentError, 'destination_app must be configured'
     end
 
+    def ensure_subscription!
+      @sub_mgr.ensure_consumer!
+      @psub = @sub_mgr.subscribe!
+    end
+
     # Returns number of messages processed; 0 on timeout/idle or after recovery.
     def process_batch
       msgs = fetch_messages
-      process_messages(msgs)
+      return 0 if msgs.nil? || msgs.empty?
+
+      msgs.sum { |m| process_one(m) }
     rescue NATS::Timeout, NATS::IO::Timeout
       0
     rescue NATS::JetStream::Error => e
       handle_js_error(e)
+    rescue StandardError => e
+      Logging.error("Unexpected process_batch error: #{e.class} #{e.message}", tag: 'JetstreamBridge::Consumer')
+      0
     end
 
     # --- helpers ---
@@ -68,10 +90,6 @@ module JetstreamBridge
       @psub.fetch(@batch_size, timeout: FETCH_TIMEOUT_SECS)
     end
 
-    def process_messages(msgs)
-      msgs.sum { |m| process_one(m) }
-    end
-
     def process_one(msg)
       if @inbox_proc
         @inbox_proc.process(msg) ? 1 : 0
@@ -79,6 +97,10 @@ module JetstreamBridge
         @processor.handle_message(msg)
         1
       end
+    rescue StandardError => e
+      # Safety: never let a single bad message kill the batch loop.
+      Logging.error("Message processing crashed: #{e.class} #{e.message}", tag: 'JetstreamBridge::Consumer')
+      0
     end
 
     def handle_js_error(e)
@@ -87,22 +109,36 @@ module JetstreamBridge
           "Recovering subscription after error: #{e.class} #{e.message}",
           tag: 'JetstreamBridge::Consumer'
         )
-        @sub_mgr.ensure_consumer!
-        @psub = @sub_mgr.subscribe!
+        ensure_subscription!
       else
-        Logging.error(
-          "Fetch failed: #{e.class} #{e.message}",
-          tag: 'JetstreamBridge::Consumer'
-        )
+        Logging.error("Fetch failed (non-recoverable): #{e.class} #{e.message}", tag: 'JetstreamBridge::Consumer')
       end
       0
     end
 
     def recoverable_consumer_error?(error)
       msg = error.message.to_s
+      code = js_err_code(msg)
+      # Heuristics: consumer/stream missing, no responders, or common 404-ish cases
       msg =~ /consumer.*(not\s+found|deleted)/i ||
         msg =~ /no\s+responders/i ||
-        msg =~ /stream.*not\s+found/i
+        msg =~ /stream.*not\s+found/i ||
+        code == 404
+    end
+
+    def js_err_code(message)
+      m = message.match(/err_code=(\d{3,5})/)
+      m ? m[1].to_i : nil
+    end
+
+    def idle_sleep(processed)
+      if processed.zero?
+        # exponential-ish backoff with a tiny jitter to avoid sync across workers
+        @idle_backoff = [@idle_backoff * 1.5, MAX_IDLE_BACKOFF_SECS].min
+        sleep(@idle_backoff + (rand * 0.01))
+      else
+        @idle_backoff = IDLE_SLEEP_SECS
+      end
     end
   end
 end

data/lib/jetstream_bridge/consumer/dlq_publisher.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require 'json'
+require 'oj'
 require 'time'
 require_relative '../core/logging'
 
@@ -46,7 +46,7 @@ module JetstreamBridge
       headers['x-dead-letter'] = 'true'
       headers['x-dlq-reason']  = reason
       headers['x-deliveries']  = deliveries.to_s
-      headers['x-dlq-context'] = JSON.generate(envelope)
+      headers['x-dlq-context'] = Oj.dump(envelope, mode: :compat)
       headers
     end
   end

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

@@ -1,37 +1,37 @@
 # frozen_string_literal: true
 
-require 'json'
+require 'oj'
 
 module JetstreamBridge
   # Immutable value object for a single NATS message.
   class InboxMessage
     attr_reader :msg, :seq, :deliveries, :stream, :subject, :headers, :body, :raw, :event_id, :now
 
-    def self.from_nats(m)
-      meta       = (m.respond_to?(:metadata) && m.metadata) || nil
+    def self.from_nats(msg)
+      meta       = (msg.respond_to?(:metadata) && msg.metadata) || nil
       seq        = meta.respond_to?(:stream_sequence) ? meta.stream_sequence : nil
       deliveries = meta.respond_to?(:num_delivered)   ? meta.num_delivered   : nil
       stream     = meta.respond_to?(:stream)          ? meta.stream          : nil
-      subject    = m.subject.to_s
+      subject    = msg.subject.to_s
 
       headers = {}
-      (m.header || {}).each { |k, v| headers[k.to_s.downcase] = v }
+      (msg.header || {}).each { |k, v| headers[k.to_s.downcase] = v }
 
-      raw  = m.data
+      raw  = msg.data
       body = begin
-        JSON.parse(raw)
-      rescue StandardError
+        Oj.load(raw, mode: :strict)
+      rescue Oj::Error
         {}
       end
 
       id = (headers['nats-msg-id'] || body['event_id']).to_s.strip
       id = "seq:#{seq}" if id.empty?
 
-      new(m, seq, deliveries, stream, subject, headers, body, raw, id, Time.now.utc)
+      new(msg, seq, deliveries, stream, subject, headers, body, raw, id, Time.now.utc)
     end
 
-    def initialize(m, seq, deliveries, stream, subject, headers, body, raw, event_id, now)
-      @msg        = m
+    def initialize(msg, seq, deliveries, stream, subject, headers, body, raw, event_id, now)
+      @msg        = msg
       @seq        = seq
       @deliveries = deliveries
       @stream     = stream

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

@@ -13,24 +13,24 @@ module JetstreamBridge
     end
 
     # @return [true,false] processed?
-    def process(m)
+    def process(msg)
       klass = ModelUtils.constantize(JetstreamBridge.config.inbox_model)
-      return process_direct(m, klass) unless ModelUtils.ar_class?(klass)
+      return process_direct?(msg, klass) unless ModelUtils.ar_class?(klass)
 
-      msg   = InboxMessage.from_nats(m)
+      msg   = InboxMessage.from_nats(msg)
       repo  = InboxRepository.new(klass)
       record = repo.find_or_build(msg)
 
       if repo.already_processed?(record)
-        m.ack
+        msg.ack
         return true
       end
 
       repo.persist_pre(record, msg)
-      @processor.handle_message(m)
+      @processor.handle_message(msg)
       repo.persist_post(record)
       true
-    rescue => e
+    rescue StandardError => e
       repo.persist_failure(record, e) if defined?(repo) && defined?(record)
       Logging.error("Inbox processing failed: #{e.class}: #{e.message}",
                     tag: 'JetstreamBridge::Consumer')
@@ -39,12 +39,12 @@ module JetstreamBridge
 
     private
 
-    def process_direct(m, klass)
+    def process_direct?(msg, klass)
       unless ModelUtils.ar_class?(klass)
         Logging.warn("Inbox model #{klass} is not an ActiveRecord model; processing directly.",
                      tag: 'JetstreamBridge::Consumer')
       end
-      @processor.handle_message(m)
+      @processor.handle_message(msg)
       true
     end
   end

data/lib/jetstream_bridge/consumer/message_context.rb

@@ -10,12 +10,12 @@ module JetstreamBridge
   ) do
     def self.build(msg)
       new(
-        event_id:   msg.header&.[]('nats-msg-id') || SecureRandom.uuid,
+        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
+        subject: msg.subject,
+        seq: msg.metadata&.sequence,
+        consumer: msg.metadata&.consumer,
+        stream: msg.metadata&.stream
       )
     end
   end

data/lib/jetstream_bridge/consumer/message_processor.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require 'json'
+require 'oj'
 require_relative '../core/logging'
 require_relative 'message_context'
 require_relative 'dlq_publisher'
@@ -37,12 +37,8 @@ module JetstreamBridge
 
     def parse_message(msg, ctx)
       data = msg.data
-      if defined?(Oj)
-        Oj.load(data, mode: :strict)
-      else
-        JSON.parse(data)
-      end
-    rescue JSON::ParserError => e
+      Oj.load(data, mode: :strict)
+    rescue Oj::ParseError => e
       @dlq.publish(msg, ctx,
                    reason: 'malformed_json', error_class: e.class.name, error_message: e.message)
       msg.ack

data/lib/jetstream_bridge/consumer/subscription_manager.rb

@@ -11,6 +11,8 @@ module JetstreamBridge
       @jts     = jts
       @durable = durable
       @cfg     = cfg
+      @desired_cfg      = ConsumerConfig.consumer_config(@durable, filter_subject)
+      @desired_cfg_norm = normalize_consumer_config(@desired_cfg)
     end
 
     def stream_name
@@ -22,18 +24,18 @@ module JetstreamBridge
     end
 
     def desired_consumer_cfg
-      ConsumerConfig.consumer_config(@durable, filter_subject)
+      @desired_cfg
     end
 
     def ensure_consumer!
       info = consumer_info_or_nil
       return create_consumer! unless info
 
-      want = desired_consumer_cfg
-      if consumer_matches?(info, want)
+      have_norm = normalize_consumer_config(info.config)
+      if have_norm == @desired_cfg_norm
         log_consumer_ok
       else
-        log_consumer_diff(info, want)
+        log_consumer_diff(have_norm)
         recreate_consumer!
       end
     end
@@ -58,15 +60,8 @@ module JetstreamBridge
 
     # ---- comparison ----
 
-    def consumer_matches?(info, want)
-      have_norm = normalize_consumer_config(info.config)
-      want_norm = normalize_consumer_config(want)
-      have_norm == want_norm
-    end
-
-    def log_consumer_diff(info, want)
-      have_norm = normalize_consumer_config(info.config)
-      want_norm = normalize_consumer_config(want)
+    def log_consumer_diff(have_norm)
+      want_norm = @desired_cfg_norm
 
       diffs = {}
       (have_norm.keys | want_norm.keys).each do |k|
@@ -86,8 +81,8 @@ module JetstreamBridge
         filter_subject: sval(cfg, :filter_subject), # string
         ack_policy: sval(cfg, :ack_policy), # string
         deliver_policy: sval(cfg, :deliver_policy), # string
-        max_deliver: ival(cfg, :max_deliver),         # integer
-        ack_wait_ms: d_ms(cfg, :ack_wait),            # integer ms
+        max_deliver: ival(cfg, :max_deliver), # integer
+        ack_wait: d_ms(cfg, :ack_wait), # integer ms
         backoff_ms: darr_ms(cfg, :backoff) # array of integer ms
       }
     end

data/lib/jetstream_bridge/core/connection.rb

@@ -2,7 +2,7 @@
 
 require 'nats/io/client'
 require 'singleton'
-require 'json'
+require 'oj'
 require_relative 'duration'
 require_relative 'logging'
 require_relative 'config'

data/lib/jetstream_bridge/core/duration.rb

@@ -14,6 +14,7 @@ module JetstreamBridge
   # Examples:
   #   Duration.to_millis(30)                        #=> 30000   (auto)
   #   Duration.to_millis(1500)                      #=> 1500    (auto)
+  #   Duration.to_millis("1500")                    #=> 1500    (auto)
   #   Duration.to_millis(1500, default_unit: :s)    #=> 1_500_000
   #   Duration.to_millis("30s")                     #=> 30000
   #   Duration.to_millis("500ms")                   #=> 500
@@ -48,7 +49,7 @@ module JetstreamBridge
       case val
       when Integer then int_to_ms(val, default_unit: default_unit)
       when Float   then float_to_ms(val, default_unit: default_unit)
-      when String  then string_to_ms(val, default_unit: default_unit == :auto ? :s : default_unit)
+      when String  then string_to_ms(val, default_unit: default_unit)
       else
         raise ArgumentError, "invalid duration type: #{val.class}" unless val.respond_to?(:to_f)
 
@@ -59,7 +60,10 @@ module JetstreamBridge
 
     # Normalize an array of durations into integer milliseconds.
     def normalize_list_to_millis(values, default_unit: :auto)
-      Array(values).map { |v| to_millis(v, default_unit: default_unit) }
+      vals = Array(values)
+      return [] if vals.empty?
+
+      vals.map { |v| to_millis(v, default_unit: default_unit) }
     end
 
     # --- internal helpers ---
@@ -70,7 +74,7 @@ module JetstreamBridge
         # Preserve existing heuristic for compatibility
         num >= 1_000 ? num : num * 1_000
       else
-        coerce_numeric_to_ms(i.to_f, default_unit)
+        coerce_numeric_to_ms(num.to_f, default_unit)
       end
     end
 
@@ -80,8 +84,9 @@ module JetstreamBridge
 
     def string_to_ms(str, default_unit:)
       s = str.strip
-      # Plain number string => use default_unit explicitly (not heuristic)
-      return coerce_numeric_to_ms(s.delete('_').to_f, default_unit) if NUMBER_RE.match?(s)
+      # Plain number strings are treated like integers so the :auto
+      # heuristic still applies (<1000 => seconds, >=1000 => ms).
+      return int_to_ms(s.delete('_').to_i, default_unit: default_unit) if NUMBER_RE.match?(s)
 
       m = TOKEN_RE.match(s)
       raise ArgumentError, "invalid duration: #{str.inspect}" unless m

data/lib/jetstream_bridge/core/model_codec_setup.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'oj'
+
 module JetstreamBridge
   module ModelCodecSetup
     module_function
@@ -17,7 +19,7 @@ module JetstreamBridge
         next unless column?(klass, attr)
         next if json_column?(klass, attr) || already_serialized?(klass, attr)
 
-        klass.serialize attr.to_sym, coder: JSON
+        klass.serialize attr.to_sym, coder: Oj
       end
     rescue ActiveRecord::StatementInvalid, ActiveRecord::ConnectionNotEstablished, ActiveRecord::NoDatabaseError
       # ignore when schema isn’t available yet

data/lib/jetstream_bridge/core/model_utils.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'oj'
+
 module JetstreamBridge
   module ModelUtils
     module_function
@@ -36,15 +38,18 @@ module JetstreamBridge
     end
 
     def json_dump(obj)
-      obj.is_a?(String) ? obj : JSON.generate(obj)
-    rescue
+      return obj if obj.is_a?(String)
+
+      Oj.dump(obj, mode: :compat)
+    rescue Oj::Error, TypeError
       obj.to_s
     end
 
     def json_load(str)
       return str if str.is_a?(Hash)
-      JSON.parse(str.to_s)
-    rescue
+
+      Oj.load(str.to_s, mode: :strict)
+    rescue Oj::Error
       {}
     end
   end

data/lib/jetstream_bridge/inbox_event.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'oj'
+
 begin
   require 'active_record'
 rescue LoadError
@@ -84,8 +86,8 @@ module JetstreamBridge
         v = self[:payload]
         case v
         when String then begin
-          JSON.parse(v)
-        rescue StandardError
+          Oj.load(v, mode: :strict)
+        rescue Oj::Error
           {}
         end
         when Hash then v
@@ -110,8 +112,8 @@ module JetstreamBridge
         def raise_missing_ar!(which, method_name)
           raise(
             "#{which} requires ActiveRecord (tried to call ##{method_name}). " \
-            'Enable `use_inbox` only in apps with ActiveRecord, or add ' \
-            '`gem \"activerecord\"` to your Gemfile.'
+            "Enable `use_inbox` only in apps with ActiveRecord, or add " \
+            "`gem \"activerecord\"` to your Gemfile."
           )
         end
       end

data/lib/jetstream_bridge/outbox_event.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require 'json'
+require 'oj'
 
 begin
   require 'active_record'
@@ -93,8 +93,8 @@ module JetstreamBridge
         v = self[:payload]
         case v
         when String then begin
-          JSON.parse(v)
-        rescue StandardError
+          Oj.load(v, mode: :strict)
+        rescue Oj::Error
           {}
         end
         when Hash then v
@@ -120,8 +120,8 @@ module JetstreamBridge
         def raise_missing_ar!(which, method_name)
           raise(
             "#{which} requires ActiveRecord (tried to call ##{method_name}). " \
-            'Enable `use_outbox` only in apps with ActiveRecord, or add ' \
-            '`gem "activerecord"` to your Gemfile.'
+            "Enable `use_outbox` only in apps with ActiveRecord, or add " \
+            "`gem \"activerecord\"` to your Gemfile."
           )
         end
       end

data/lib/jetstream_bridge/publisher/publisher.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require 'json'
+require 'oj'
 require 'securerandom'
 require_relative '../core/connection'
 require_relative '../core/logging'
@@ -50,12 +50,21 @@ module JetstreamBridge
     def do_publish?(subject, envelope)
       headers = { 'nats-msg-id' => envelope['event_id'] }
 
-      @jts.publish(subject, JSON.generate(envelope), header: headers)
-      Logging.info(
-        "Published #{subject} event_id=#{envelope['event_id']}",
-        tag: 'JetstreamBridge::Publisher'
-      )
-      true
+      ack = @jts.publish(subject, Oj.dump(envelope, mode: :compat), header: headers)
+      duplicate = ack.respond_to?(:duplicate?) && ack.duplicate?
+      msg = "Published #{subject} event_id=#{envelope['event_id']}"
+      msg += ' (duplicate)' if duplicate
+
+      Logging.info(msg, tag: 'JetstreamBridge::Publisher')
+
+      if ack.respond_to?(:error) && ack.error
+        Logging.error(
+          "Publish ack error: #{ack.error}",
+          tag: 'JetstreamBridge::Publisher'
+        )
+      end
+
+      !ack.respond_to?(:error) || ack.error.nil?
     end
 
     # ---- Outbox path ----

data/lib/jetstream_bridge/topology/overlap_guard.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require 'json'
+require 'oj'
 require_relative 'subject_matcher'
 require_relative '../core/logging'
 
@@ -68,8 +68,8 @@ module JetstreamBridge
 
       def js_api_request(jts, subject, payload = {})
         # JetStream client should expose the underlying NATS client as `nc`
-        msg = jts.nc.request(subject, JSON.dump(payload))
-        JSON.parse(msg.data)
+        msg = jts.nc.request(subject, Oj.dump(payload, mode: :compat))
+        Oj.load(msg.data, mode: :strict)
       end
 
       def conflict_message(target, conflicts)

data/lib/jetstream_bridge/topology/subject_matcher.rb

@@ -34,12 +34,12 @@ module JetstreamBridge
       return true if i == p.length && i == s.length
 
       # If pattern has remaining '>' it can absorb remainder
-      p[i] == '>' || p[i..-1]&.include?('>')
+      p[i] == '>' || p[i..]&.include?('>')
     end
 
     # Do two wildcard patterns admit at least one same subject?
-    def overlap?(a, b)
-      overlap_parts?(a.split('.'), b.split('.'))
+    def overlap?(sub_a, sub_b)
+      overlap_parts?(sub_a.split('.'), sub_b.split('.'))
     end
 
     def overlap_parts?(a_parts, b_parts)
@@ -50,13 +50,14 @@ module JetstreamBridge
         bt = b_parts[bi]
         return true if at == '>' || bt == '>'
         return false unless at == bt || 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..-1] || []
-      b_tail = b_parts[bi..-1] || []
+      a_tail = a_parts[ai..] || []
+      b_tail = b_parts[bi..] || []
       return true if a_tail.include?('>') || b_tail.include?('>')
 
       # Otherwise they overlap only if both consumed exactly

data/lib/jetstream_bridge/version.rb

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

data/lib/jetstream_bridge.rb

@@ -46,9 +46,19 @@ module JetstreamBridge
       config.use_dlq
     end
 
-    def ensure_topology?
+    # Establishes a connection and ensures stream topology.
+    #
+    # @return [Object] JetStream context
+    def ensure_topology!
       Connection.connect!
-      true
+      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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jetstream_bridge
 version: !ruby/object:Gem::Version
-  version: 2.6.0
+  version: 2.8.0
 platform: ruby
 authors:
 - Mike Attara
@@ -11,7 +11,7 @@ cert_chain: []
 date: 2025-08-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: activesupport
+  name: activerecord
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -25,7 +25,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '6.0'
 - !ruby/object:Gem::Dependency
-  name: activerecord
+  name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -66,90 +66,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '3.16'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '13.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '13.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '3.12'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '3.12'
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.66'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.66'
-- !ruby/object:Gem::Dependency
-  name: rubocop-packaging
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.5'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.5'
-- !ruby/object:Gem::Dependency
-  name: rubocop-performance
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.21'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.21'
-- !ruby/object:Gem::Dependency
-  name: bundler-audit
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.9.1
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.9.1
 description: |-
   Publisher/Consumer utilities for NATS JetStream with environment-scoped subjects,
   overlap guards, DLQ routing, retries/backoff, and optional Inbox/Outbox patterns.