jetstream_bridge 4.6.0 → 5.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1c096b0554cb1a7800a2da1c6ddd39067014bff67169d12d5669159f7253c32
-  data.tar.gz: 5e8ee34b68ad114c72d2e754b8d1985eefe267fe2674e55631f3300dd91438db
+  metadata.gz: 57dcefdf122e13d34d7e913de043e5364d96f806f10186fb436006aad766fc06
+  data.tar.gz: 0bd04edc07f63b58751485185a1f6fa1d1126d82b820cdb710ff11fcda069011
 SHA512:
-  metadata.gz: 0bd796f2987bd962f4ea5a871302e2a38ace2027164469c827cdd6e203f722a1a6457aa3dbb003f2095dfb9cef365436ca5cfea8697ec7e59222a631b2768fdf
-  data.tar.gz: a6fc7288fe11ad05d9bd80e853f128fd303cd7d22bf49aff3f0adaa092bec4c8ebcaad63cbf2cb8c1d0ba2ce05e66097483f94b5579b357de67eb877398e1274
+  metadata.gz: '029e51b5542c45f2640626fe87e8c09aee28cd4a2f76b71df227dac3460fe480a3e72bae04ec6a829789b910e1bf36a2728b907a32aeaea726228db3ec057a54'
+  data.tar.gz: 70ffe09b2ab397d53179607d708bf8ff6dbf17bb8405836b292098c894ee2d955a4d3e74efdca5502c8bbb7caf7ce8b627768601e1bb0890953ce01c5c3ddbcc

data/README.md

@@ -34,7 +34,7 @@ Production-ready NATS JetStream bridge for Ruby/Rails with outbox, inbox, DLQ, a
 
 ```ruby
 # Gemfile
-gem "jetstream_bridge", "~> 4.5"
+gem "jetstream_bridge", "~> 5.0"
 ```
 
 ```bash

data/docs/GETTING_STARTED.md

@@ -6,7 +6,7 @@ This guide covers installation, Rails setup, configuration, and basic publish/co
 
 ```ruby
 # Gemfile
-gem "jetstream_bridge", "~> 4.5"
+gem "jetstream_bridge", "~> 5.0"
 ```
 
 ```bash

data/docs/RESTRICTED_PERMISSIONS.md

@@ -662,7 +662,7 @@ subscribe: { allow: ["pwas.>"] }
 
 If you have any influence over NATS permissions, you have two options:
 
-### Option 1: Pull Consumers (Default)
+### Option 1: Pull Consumers (Default) - Summary
 
 Request minimal JetStream API permissions:
 

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

@@ -16,7 +16,9 @@ JetstreamBridge.configure do |config|
   # Stream name (required) - managed separately from runtime credentials
   config.stream_name = ENV.fetch('JETSTREAM_STREAM_NAME', 'jetstream-bridge-stream')
 
-  # Application name (used in subject routing)
+  # Application name (used in subject routing and consumer naming)
+  # IMPORTANT: Do not include environment identifiers (e.g., use "myapp" not "myapp-production")
+  # Consumer names are shared across environments for the same application
   config.app_name = ENV.fetch('APP_NAME', Rails.application.class.module_parent_name.underscore)
 
   # Destination app for cross-app sync (REQUIRED for publishing/consuming)

data/lib/jetstream_bridge/core/config.rb

@@ -8,6 +8,10 @@ module JetstreamBridge
   # Holds all configuration settings including NATS connection details,
   # application identifiers, reliability features, and consumer tuning.
   #
+  # IMPORTANT: app_name should not include environment identifiers
+  # (e.g., use "api" not "api-production") as consumer names are
+  # shared across environments for the same application.
+  #
   # @example Basic configuration
   #   JetstreamBridge.configure do |config|
   #     config.nats_urls = "nats://localhost:4222"
@@ -54,7 +58,8 @@ module JetstreamBridge
     # JetStream stream name (required)
     # @return [String]
     attr_accessor :stream_name
-    # Application name for subject routing
+    # Application name for subject routing and consumer naming.
+    # Should not include environment identifiers (e.g., use "api" not "api-production").
     # @return [String]
     attr_accessor :app_name
     # Maximum delivery attempts before moving to DLQ
@@ -193,6 +198,15 @@ module JetstreamBridge
 
     # Get the durable consumer name for this application.
     #
+    # Returns the app_name with "-workers" suffix. Consumer names are
+    # shared across environments, so app_name should not include
+    # environment identifiers (e.g., use "myapp" not "myapp-production").
+    #
+    # @return [String] Durable consumer name
+    # @example
+    #   config.app_name = "notifications"
+    #   config.durable_name  # => "notifications-workers"
+    #
     def durable_name
       "#{app_name}-workers"
     end
@@ -280,6 +294,8 @@ module JetstreamBridge
     end
 
     def validate_consumer_mode!(errors)
+      return errors << 'consumer_mode must be :pull or :push' if consumer_mode.nil?
+
       errors << 'consumer_mode must be :pull or :push' unless [:pull, :push].include?(consumer_mode.to_sym)
     end
   end

data/lib/jetstream_bridge/provisioner.rb

@@ -25,8 +25,8 @@ module JetstreamBridge
     def ensure!(jts: nil, ensure_consumer: true)
       js = jts || Connection.connect!(verify_js: true)
 
-      ensure_stream!(js)
-      ensure_consumer!(js) if ensure_consumer
+      ensure_stream!(jts: js)
+      ensure_consumer!(jts: js) if ensure_consumer
 
       Logging.info(
         "Provisioned stream=#{@config.stream_name} consumer=#{@config.durable_name if ensure_consumer}",

data/lib/jetstream_bridge/version.rb

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

metadata

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