jetstream_bridge 4.2.0 → 4.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 40f09bd9d0341dd242cbd29f7eaa4c848d180886f4e11c76ca97fca5f312e8d9
-  data.tar.gz: e2d8d22a90787f7824953c4d869ecc57e8eaebcd6948ed18a45033684dc45ce5
+  metadata.gz: fe94130ab86adb28c2623f20b6ad744cb51550fa2130750cbdcb30a0949e002e
+  data.tar.gz: 97e0957974e440f4ecb5ae7b129920da0e60bc727a07c03764b67035ebcdacd6
 SHA512:
-  metadata.gz: 0bdc25b39ba3fdd08c70795f2db348c2155951af8a88d5acbca55eac6a36850ffaa4b9cc103e8a9774080aa798ba871792a7d9604f79ef94734164b7b9bbc9f3
-  data.tar.gz: 54f528ac27f9031adbc794e4d31d7ba0d88f241dec379e063592b80a51a67cc0f3a9bb9af640a28d7d810de4686b17093ca79b3576ed48aa0198639f42fb1782
+  metadata.gz: be18e0b5fff0b38a5605d86ac870a73e1e471be0d8aae4eb122dd4f4a7084399156fc4a5a2249344d46eea01b385cdf51476c42ed2e782b8b75997ef200eb2c6
+  data.tar.gz: 5063a30a0146f6dc6acafded1a86ef12e7aab41edb13f99c5c3366c507a4a277f0c92ef957d2ce73178ae8ef48aae5320190f748890f0cff160220196c1ddb8f

data/CHANGELOG.md

@@ -5,6 +5,42 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.3.0] - 2025-11-24
+
+### Added
+
+- **Connection Diagnostics** - Exposed reconnection error tracking for health checks
+  - `last_reconnect_error` and `last_reconnect_error_at` now publicly accessible
+  - Enables better monitoring and diagnostics of connection issues
+  - Added test coverage for diagnostic accessor visibility
+
+### Changed
+
+- **Connection Lifecycle** - Improved topology management during startup
+  - `startup!` now explicitly ensures topology is created during initialization
+  - `connect_and_ensure_stream!` properly ensures topology after connecting
+  - `fetch_stream_info` now ensures connection is established before querying
+  - More reliable initialization sequence for non-Rails applications
+
+- **Rails Integration** - Changed console autostart behavior
+  - Rails console now autostarts JetStream Bridge by default (previously skipped)
+  - Simplified autostart logic by removing console detection as skip condition
+  - Autostart remains disabled only for rake tasks (unless forced with `JETSTREAM_BRIDGE_FORCE_AUTOSTART`)
+  - Better developer experience in Rails console for immediate testing
+
+- **Documentation** - Clarified connection initialization behavior
+  - Added notes explaining that `configure` only sets options and does not connect
+  - Documented when connection actually occurs (Rails: after initialization; non-Rails: call `startup!`)
+  - Improved explanation of `lazy_connect` behavior in Rails environments
+  - Added guidance for non-Rails applications to call `startup!` explicitly
+
+### Fixed
+
+- **Test Coverage** - Added missing test scenarios
+  - Added tests for topology ensuring in `startup!` and `connect_and_ensure_stream!`
+  - Added tests for connection initialization in `stream_info`
+  - Updated Rails integration specs to reflect new console behavior
+
 ## [4.2.0] - 2025-11-24
 
 ### Added

data/README.md

@@ -54,6 +54,10 @@ JetstreamBridge.configure do |config|
   config.use_inbox  = true
   config.use_dlq    = true
 end
+
+# Note: configure only sets options; it does not connect. In Rails the Railtie
+# starts the bridge after initialization. In non-Rails apps call
+# `JetstreamBridge.startup!` (or rely on auto-connect on first publish/subscribe).
 ```
 
 Publish:

data/docs/GETTING_STARTED.md

@@ -52,9 +52,14 @@ JetstreamBridge.configure do |config|
   config.ack_wait    = "30s"
   config.backoff     = %w[1s 5s 15s 30s 60s]
 end
+
+# Note: `configure` only sets options; it does not connect. Rails will start
+# JetstreamBridge after initialization via the Railtie. For non-Rails or custom
+# boot flows, call `JetstreamBridge.startup!` (or rely on auto-connect on first
+# publish/subscribe).
 ```
 
-Rails autostart can be disabled for rake/console by `config.lazy_connect = true` or `JETSTREAM_BRIDGE_DISABLE_AUTOSTART=1`; it will connect on first publish/subscribe.
+Rails autostart runs after initialization (including in console). You can opt out for rake tasks or other tooling with `config.lazy_connect = true` or `JETSTREAM_BRIDGE_DISABLE_AUTOSTART=1`; it will then connect on first publish/subscribe.
 
 ## Publish
 

data/lib/jetstream_bridge/core/bridge_helpers.rb

@@ -37,7 +37,12 @@ module JetstreamBridge
       end
 
       def fetch_stream_info
+        # Ensure we have an active connection before querying stream info
+        connect_if_needed!
+
         jts = Connection.jetstream
+        raise ConnectionNotEstablishedError, 'NATS connection not established' unless jts
+
         info = jts.stream_info(config.stream_name)
 
         # Handle both object-style and hash-style access for compatibility

data/lib/jetstream_bridge/core/connection.rb

@@ -135,6 +135,9 @@ module JetstreamBridge
     # @return [Time, nil] timestamp when connection was established
     attr_reader :connected_at
 
+    # Last reconnection error metadata (exposed for health checks/diagnostics)
+    attr_reader :last_reconnect_error, :last_reconnect_error_at
+
     # Get current connection state
     #
     # @return [Symbol] Current connection state (see State module)
@@ -429,10 +432,6 @@ module JetstreamBridge
       @last_health_check = Time.now.to_i
     end
 
-    # Get last reconnection error for diagnostics
-    # @return [StandardError, nil] Last error during reconnection
-    attr_reader :last_reconnect_error, :last_reconnect_error_at
-
     # Expose for class-level helpers (not part of public API)
     attr_reader :nc
 

data/lib/jetstream_bridge/rails/integration.rb

@@ -71,13 +71,12 @@ module JetstreamBridge
 
         JetstreamBridge.config.lazy_connect ||
           env_disables_autostart? ||
-          skip_autostart_for_rails_tooling?
+          rake_task?
       end
 
       def autostart_skip_reason
         return 'lazy_connect enabled' if JetstreamBridge.config.lazy_connect
         return 'JETSTREAM_BRIDGE_DISABLE_AUTOSTART set' if env_disables_autostart?
-        return 'Rails console' if rails_console?
         return 'rake task' if rake_task?
 
         'unknown'
@@ -137,10 +136,6 @@ module JetstreamBridge
         !!defined?(::Rake) || File.basename($PROGRAM_NAME) == 'rake'
       end
 
-      def skip_autostart_for_rails_tooling?
-        rails_console? || rake_task?
-      end
-
       def active_logger
         if defined?(::Rails) && ::Rails.respond_to?(:logger)
           ::Rails.logger

data/lib/jetstream_bridge/version.rb

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

data/lib/jetstream_bridge.rb

@@ -133,14 +133,13 @@ module JetstreamBridge
 
     # Initialize the JetStream Bridge connection and topology
     #
-    # This method is called automatically by `configure`, but can be called
-    # explicitly if needed. It's idempotent and safe to call multiple times.
+    # This method can be called explicitly if needed. It's idempotent and safe to call multiple times.
     #
     # @return [void]
     def startup!
       return if @connection_initialized
 
-      Connection.connect!
+      connect_and_ensure_stream!
       @connection_initialized = true
       Logging.info('JetStream Bridge started successfully', tag: 'JetstreamBridge')
     end
@@ -202,7 +201,9 @@ module JetstreamBridge
     # @return [Object] JetStream context
     def connect_and_ensure_stream!
       Connection.connect!
-      Connection.jetstream
+      jts = Connection.jetstream
+      Topology.ensure!(jts)
+      jts
     end
 
     # Backwards-compatible alias for the previous method name

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jetstream_bridge
 version: !ruby/object:Gem::Version
-  version: 4.2.0
+  version: 4.3.0
 platform: ruby
 authors:
 - Mike Attara