react_on_rails_pro 16.6.0.rc.0 → 16.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f373b7e8f1b22b6a346f76eee9e85bf438104439a5d6250ccd8be773cbbdf86d
-  data.tar.gz: a846f06b5f699c0bf61404237593be4d72e105cec55a152a77ecc80de549efd0
+  metadata.gz: 91309f642414eae0ab09407243def617e7f32b2b9db0d0b62b108984d31b41e0
+  data.tar.gz: 1dec0600d12b121c3bbe62390a0c36124efed1fe40a5a53b0485d6b74e764a25
 SHA512:
-  metadata.gz: b97234a2ae969d0625912780700bffebe01268b7c183b70b56d1707dd6f0ce012f2b7b8d3ab71315d5667bacbb71188c67bad93715a3171cf063b7a0dbc2d340
-  data.tar.gz: 9433436cd0acf2c2c8a523972946010aa3dc5905d7efc980ce7586bb70bf77b5535deab295f9a5b2fe917c26eca13ce4367dd109184c9df2154c0fab6258c28a
+  metadata.gz: 32a8382d7d10c90e475ebcd76607e6716b1e73766c228bb43362a33ca8223efd9cd5470a1c012cc82ec1c957356047351c35e988daed3f27e1a552cde7108a32
+  data.tar.gz: 7096efd3fb7dfe712b14f116977b9827594ae7b6505e90842f5d2213c564efc67a890fa7051c53c4373a10e303e35adee23dc27caf95f0cd68e91c70de1d57de

data/Gemfile.lock

@@ -9,7 +9,7 @@ GIT
 PATH
   remote: ..
   specs:
-    react_on_rails (16.6.0.rc.0)
+    react_on_rails (16.6.0)
       addressable
       connection_pool
       execjs (~> 2.5)
@@ -20,7 +20,7 @@ PATH
 PATH
   remote: .
   specs:
-    react_on_rails_pro (16.6.0.rc.0)
+    react_on_rails_pro (16.6.0)
       addressable
       async (>= 2.29)
       connection_pool
@@ -29,7 +29,7 @@ PATH
       httpx (~> 1.5)
       jwt (~> 2.7)
       rainbow
-      react_on_rails (= 16.6.0.rc.0)
+      react_on_rails (= 16.6.0)
 
 GEM
   remote: https://rubygems.org/

data/app/helpers/react_on_rails_pro_helper.rb

@@ -128,7 +128,10 @@ module ReactOnRailsProHelper
     # stream_react_component doesn't have the prerender option
     # Because setting prerender to false is equivalent to calling react_component with prerender: false
     options[:prerender] = true
-    options = options.merge(immediate_hydration: true) unless options.key?(:immediate_hydration)
+    if options.key?(:immediate_hydration)
+      ReactOnRails::Helper.warn_removed_immediate_hydration_option("stream_react_component")
+      options.delete(:immediate_hydration)
+    end
 
     # Extract streaming-specific callback
     on_complete = options.delete(:on_complete)

data/lib/react_on_rails_pro/configuration.rb

@@ -15,6 +15,7 @@ module ReactOnRailsPro
       renderer_http_pool_size: Configuration::DEFAULT_RENDERER_HTTP_POOL_SIZE,
       renderer_http_pool_timeout: Configuration::DEFAULT_RENDERER_HTTP_POOL_TIMEOUT,
       renderer_http_pool_warn_timeout: Configuration::DEFAULT_RENDERER_HTTP_POOL_WARN_TIMEOUT,
+      renderer_http_keep_alive_timeout: Configuration::DEFAULT_RENDERER_HTTP_KEEP_ALIVE_TIMEOUT,
       renderer_password: nil,
       tracing: Configuration::DEFAULT_TRACING,
       dependency_globs: Configuration::DEFAULT_DEPENDENCY_GLOBS,
@@ -44,6 +45,7 @@ module ReactOnRailsPro
     DEFAULT_RENDERER_HTTP_POOL_SIZE = 10
     DEFAULT_RENDERER_HTTP_POOL_TIMEOUT = 5
     DEFAULT_RENDERER_HTTP_POOL_WARN_TIMEOUT = 0.25
+    DEFAULT_RENDERER_HTTP_KEEP_ALIVE_TIMEOUT = 30
     DEFAULT_SSR_TIMEOUT = 5
     DEFAULT_PRERENDER_CACHING = false
     DEFAULT_TRACING = false
@@ -72,7 +74,7 @@ module ReactOnRailsPro
                   :rsc_payload_generation_url_path, :rsc_bundle_js_file, :react_client_manifest_file,
                   :react_server_client_manifest_file
 
-    attr_reader :concurrent_component_streaming_buffer_size
+    attr_reader :concurrent_component_streaming_buffer_size, :renderer_http_keep_alive_timeout
 
     # Sets the buffer size for concurrent component streaming.
     #
@@ -91,10 +93,28 @@ module ReactOnRailsPro
       @concurrent_component_streaming_buffer_size = value
     end
 
+    # Sets the keep-alive timeout (in seconds) for persistent HTTP connections to the node renderer.
+    #
+    # For best results, set this value to slightly less than the node renderer's own
+    # keep-alive / idle-connection timeout. If the client-side timeout is longer than
+    # the server's, connections may be reused after the server has already closed them,
+    # resulting in stale-connection errors. If set to nil, the HTTPX default is used.
+    #
+    # @param value [Numeric, nil] A positive number or nil (to use the HTTPX default)
+    # @raise [ReactOnRailsPro::Error] if value is not a positive number or nil
+    def renderer_http_keep_alive_timeout=(value)
+      unless value.nil? || (value.is_a?(Numeric) && value.positive? && value.finite?)
+        raise ReactOnRailsPro::Error,
+              "config.renderer_http_keep_alive_timeout must be a finite positive number or nil"
+      end
+      @renderer_http_keep_alive_timeout = value
+    end
+
     def initialize(renderer_url: nil, renderer_password: nil, server_renderer: nil, # rubocop:disable Metrics/AbcSize
                    renderer_use_fallback_exec_js: nil, prerender_caching: nil,
                    renderer_http_pool_size: nil, renderer_http_pool_timeout: nil,
-                   renderer_http_pool_warn_timeout: nil, tracing: nil,
+                   renderer_http_pool_warn_timeout: nil, renderer_http_keep_alive_timeout: nil,
+                   tracing: nil,
                    dependency_globs: nil, excluded_dependency_globs: nil, rendering_returns_promises: nil,
                    remote_bundle_cache_adapter: nil, ssr_pre_hook_js: nil, assets_to_copy: nil,
                    renderer_request_retry_limit: nil, throw_js_errors: nil, ssr_timeout: nil,
@@ -111,6 +131,7 @@ module ReactOnRailsPro
       self.renderer_http_pool_size = renderer_http_pool_size
       self.renderer_http_pool_timeout = renderer_http_pool_timeout
       self.renderer_http_pool_warn_timeout = renderer_http_pool_warn_timeout
+      self.renderer_http_keep_alive_timeout = renderer_http_keep_alive_timeout
       self.tracing = tracing
       self.rendering_returns_promises = server_renderer == "NodeRenderer" ? rendering_returns_promises : false
       self.dependency_globs = dependency_globs
@@ -230,12 +251,16 @@ module ReactOnRailsPro
 
     def setup_renderer_password
       # Explicit passwords, including values loaded from ENV in the initializer, skip URL extraction.
-      # Blank values fall through so URL extraction and production validation still catch misconfiguration.
+      # Blank values (nil or "") fall through so URL extraction and ENV fallback still apply.
       return if renderer_password.present?
 
       uri = URI(renderer_url)
       self.renderer_password = uri.password
 
+      # Mirror Node-side defaults: if Rails config and URL are both missing a password,
+      # use RENDERER_PASSWORD from env.
+      self.renderer_password = ENV.fetch("RENDERER_PASSWORD", nil) if renderer_password.blank?
+
       validate_renderer_password_for_production
     end
 
@@ -260,17 +285,23 @@ module ReactOnRailsPro
         is required. In all other environments, you must explicitly configure a password to secure
         communication between Rails and the Node Renderer.
 
-        To fix this, set the RENDERER_PASSWORD environment variable and configure it in your initializer:
+        To fix this, set the RENDERER_PASSWORD environment variable:
+
+          export RENDERER_PASSWORD="your-secure-password"
+
+        Rails reads it automatically. If you prefer to make it explicit in your initializer:
 
           # config/initializers/react_on_rails_pro.rb
           ReactOnRailsPro.configure do |config|
             config.renderer_password = ENV.fetch("RENDERER_PASSWORD")
           end
 
-        Then set the same password for the Node Renderer via the RENDERER_PASSWORD environment variable.
-        Note: setting ENV["RENDERER_PASSWORD"] alone is not enough on the Ruby side unless
-        config.renderer_password is explicitly assigned from ENV.
-        An empty-string assignment still counts as missing and will raise in production-like environments.
+        Set the same password for the Node Renderer via the RENDERER_PASSWORD environment variable.
+        Rails resolves the password in this order:
+          1) config.renderer_password (blank values fall through to the next step)
+          2) Password embedded in config.renderer_url (for example, https://:password@host:3800)
+          3) ENV["RENDERER_PASSWORD"]
+
         If Rails and the Node Renderer disagree about startup behavior, verify both RAILS_ENV and NODE_ENV.
 
         Environment matrix:

data/lib/react_on_rails_pro/constants.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 module ReactOnRailsPro
+  # Status code 400 indicates the renderer rejected the request payload or encountered an unhandled render error.
+  STATUS_BAD_REQUEST = 400
   # Status code 410 means to resend the request with the updated bundle.
   STATUS_SEND_BUNDLE = 410
   # Status code 412 means protocol versions are incompatible between the server and the renderer.

data/lib/react_on_rails_pro/request.rb

@@ -297,11 +297,11 @@ module ReactOnRailsPro
             # :write_timeout
             # :request_timeout
             # :operation_timeout
-            # :keep_alive_timeout
             timeout: {
               connect_timeout: ReactOnRailsPro.configuration.renderer_http_pool_timeout,
-              read_timeout: ReactOnRailsPro.configuration.ssr_timeout
-            }
+              read_timeout: ReactOnRailsPro.configuration.ssr_timeout,
+              keep_alive_timeout: ReactOnRailsPro.configuration.renderer_http_keep_alive_timeout
+            }.compact
           )
       rescue StandardError => e
         message = <<~MSG
@@ -309,6 +309,7 @@ module ReactOnRailsPro
           renderer_http_pool_size = #{ReactOnRailsPro.configuration.renderer_http_pool_size}
           renderer_http_pool_timeout = #{ReactOnRailsPro.configuration.renderer_http_pool_timeout}
           renderer_http_pool_warn_timeout = #{ReactOnRailsPro.configuration.renderer_http_pool_warn_timeout}
+          renderer_http_keep_alive_timeout = #{ReactOnRailsPro.configuration.renderer_http_keep_alive_timeout}
           renderer_url = #{url}
           Be sure to use a url that contains the protocol of http or https.
           Original error is

data/lib/react_on_rails_pro/server_rendering_pool/node_rendering_pool.rb

@@ -74,9 +74,10 @@ module ReactOnRailsPro
             ReactOnRailsPro::Error.raise_duplicate_bundle_upload_error if send_bundle
 
             eval_js(js_code, render_options, send_bundle: true)
-          when 400
+          when ReactOnRailsPro::STATUS_BAD_REQUEST
             raise ReactOnRailsPro::Error,
-                  "Renderer unhandled error at the VM level: #{response.status}:\n#{response.body}"
+                  "Renderer rejected malformed request or hit an unhandled VM error: " \
+                  "#{response.status}:\n#{response.body}"
           else
             raise ReactOnRailsPro::Error,
                   "Unexpected response code from renderer: #{response.status}:\n#{response.body}"

data/lib/react_on_rails_pro/stream_request.rb

@@ -140,6 +140,10 @@ module ReactOnRailsPro
         ReactOnRailsPro::Error.raise_duplicate_bundle_upload_error if send_bundle
 
         true
+      when ReactOnRailsPro::STATUS_BAD_REQUEST
+        raise ReactOnRailsPro::Error,
+              "Renderer rejected malformed request or hit an unhandled VM error: " \
+              "#{response.status}:\n#{error_body}"
       when ReactOnRailsPro::STATUS_INCOMPATIBLE
         raise ReactOnRailsPro::Error, error_body
       else

data/lib/react_on_rails_pro/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module ReactOnRailsPro
-  VERSION = "16.6.0.rc.0"
+  VERSION = "16.6.0"
   PROTOCOL_VERSION = "2.0.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: react_on_rails_pro
 version: !ruby/object:Gem::Version
-  version: 16.6.0.rc.0
+  version: 16.6.0
 platform: ruby
 authors:
 - Justin Gordon
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-02 00:00:00.000000000 Z
+date: 2026-04-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -128,14 +128,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 16.6.0.rc.0
+        version: 16.6.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 16.6.0.rc.0
+        version: 16.6.0
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement