jetstream_bridge 7.1.0 → 7.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 290f604d47d1605f6c2b2abcde100159327a7418b103c0c054b0b92f5e7fbf56
-  data.tar.gz: 485e9cf4070d9671a1994ffbde32ab8ca6e41fbfb7d94d8cf571e2e8ec04cd3b
+  metadata.gz: 65a794cf3e9a17511c64f2ef29edc70d56214f4cfc1c63eed8148afb65e05505
+  data.tar.gz: 44dea5d3d1900999fc788aad9e9d676a02315c18678256f4ce14d5443cb0b816
 SHA512:
-  metadata.gz: a1a17ed6a75d8f9b32de3efbe23da1797824c4e846c0d4d73ee1014d9ea20048367088cfaabd3f9a02179314090741237d21dffc0c618a429a47510597bb1ed8
-  data.tar.gz: f3ae4a9e9b256f4dfa1d1e84a32d66140ae01c52d07f21b8fac7976c61bb76a81cb83a53aae6631af9c0affa81eb24d81b7167ebb18875489e398f7869ebd2d6
+  metadata.gz: 360c547ece5e7443487c3796d18139843ea86a2ce7f29a775fd1245d6e084d76bec11df72cdafef78ac9fa383ad99eae680f9220dc9eef451f62ba012fe20de9
+  data.tar.gz: 62e2100993ba1defc32df1ad744392148f4600527c5fab80db6cce2d211b80c79d6228c64497e61106ba13fdef9579300df1455d5caf3d4e75a83ccd896a5051

data/CHANGELOG.md

@@ -5,6 +5,17 @@ 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).
 
+## [7.1.1] - 2026-02-02
+
+### Changed
+
+- Fail-fast consumer provisioning: when running in push mode with `auto_provision=false`, the bridge now raises `ConsumerProvisioningError` instead of silently skipping consumer setup, preventing idle workers when the durable is missing.
+- Permission-aware creation: consumer creation now surfaces `ConsumerProvisioningError` on permissions violations (pull or push mode), guiding operators to grant the minimal `$JS.API` rights or pre-provision the durable.
+
+### Added
+
+- New `ConsumerProvisioningError` topology error for clearer operator feedback when consumer setup cannot proceed.
+
 ## [7.1.0] - 2026-02-01
 
 ### Added

data/lib/jetstream_bridge/consumer/subscription_manager.rb

@@ -79,6 +79,15 @@ module JetstreamBridge
     #
     # @raise [StreamNotFoundError] if the stream doesn't exist
     def create_consumer_if_missing!
+      # In restricted environments (push + auto_provision=false), we still want fail-fast semantics.
+      # Attempt creation and raise a clear error so operators know the consumer must be pre-provisioned
+      # or the account must allow the minimal $JS.API consumer permissions.
+      if skip_consumer_management?
+        raise JetstreamBridge::ConsumerProvisioningError,
+              "Consumer '#{@durable}' not ensured because auto_provision=false and push mode is enabled. " \
+              'Provision the consumer with admin credentials or grant minimal consumer create/info permissions.'
+      end
+
       # First, verify stream exists - fail fast with clear error if not
       unless stream_exists?
         raise StreamNotFoundError,
@@ -103,6 +112,8 @@ module JetstreamBridge
     rescue StreamNotFoundError
       raise
     rescue StandardError => e
+      raise ConsumerProvisioningError, permission_error_message(e) if permission_denied?(e)
+
       # If creation fails due to consumer already existing (race condition), that's OK
       msg = e.message.to_s.downcase
       if msg.include?('already') || msg.include?('exists')
@@ -210,6 +221,21 @@ module JetstreamBridge
       config
     end
 
+    def skip_consumer_management?
+      @cfg.push_consumer? && !@cfg.auto_provision
+    end
+
+    def permission_denied?(error)
+      msg = error.message.to_s.downcase
+      msg.include?('permission') || msg.include?('permissions violation')
+    end
+
+    def permission_error_message(error)
+      "Consumer '#{@durable}' could not be ensured due to permissions: #{error.message}. " \
+        'Grant $JS.API.STREAM.INFO/$JS.API.CONSUMER.INFO/$JS.API.CONSUMER.CREATE for the stream, ' \
+        'or pre-provision the consumer with an admin account.'
+    end
+
     def create_consumer!
       @jts.add_consumer(stream_name, **desired_consumer_cfg)
       Logging.info(

data/lib/jetstream_bridge/errors.rb

@@ -67,6 +67,7 @@ module JetstreamBridge
 
   # Topology errors
   class TopologyError < Error; end
+  class ConsumerProvisioningError < TopologyError; end
   class StreamNotFoundError < TopologyError; end
   class SubjectOverlapError < TopologyError; end
   class StreamCreationFailedError < TopologyError; end

data/lib/jetstream_bridge/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jetstream_bridge
 version: !ruby/object:Gem::Version
-  version: 7.1.0
+  version: 7.1.1
 platform: ruby
 authors:
 - Mike Attara
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-01 00:00:00.000000000 Z
+date: 2026-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord