react_on_rails_pro 16.6.0 → 16.7.0.rc.1

data/lib/react_on_rails_pro/stream_request.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require "async"
+require "async/barrier"
+
 module ReactOnRailsPro
   class StreamDecorator
     def initialize(component)
@@ -92,35 +95,54 @@ module ReactOnRailsPro
     def each_chunk(&block)
       return enum_for(:each_chunk) unless block
 
-      send_bundle = false
-      error_body = +""
-      loop do
-        stream_response = @request_executor.call(send_bundle)
-
-        # Chunks can be merged during streaming, so we separate them by newlines
-        # Also, we check the status code inside the loop block because calling `status` outside the loop block
-        # is blocking, it will wait for the response to be fully received
-        # Look at the spec of `status` in `spec/react_on_rails_pro/stream_spec.rb` for more details
-        process_response_chunks(stream_response, error_body, &block)
-        break
-      rescue HTTPX::HTTPError => e
-        send_bundle = handle_http_error(e, error_body, send_bundle)
-      rescue HTTPX::ReadTimeoutError => e
-        raise ReactOnRailsPro::Error, "Time out error while server side render streaming a component.\n" \
-                                      "Original error:\n#{e}\n#{e.backtrace}"
+      Sync do
+        barrier = Async::Barrier.new
+
+        send_bundle = false
+        error_body = +""
+        loop do
+          stream_response = @request_executor.call(send_bundle, barrier)
+
+          # The Node renderer always emits the length-prefixed wire format
+          # (`<metadata JSON>\t<content byte length hex>\n<raw content bytes>`)
+          # for every response chunk — both the one-shot streaming path and the
+          # incremental-rendering path. We check the status code inside the loop
+          # block because calling `status` outside of it blocks until the full
+          # response has been received. See the `status` spec in
+          # `spec/react_on_rails_pro/stream_spec.rb` for more details.
+          process_response_chunks(stream_response, error_body, &block)
+          break
+        rescue HTTPX::HTTPError => e
+          send_bundle = handle_http_error(e, error_body, send_bundle)
+        rescue HTTPX::ReadTimeoutError => e
+          raise ReactOnRailsPro::Error, "Time out error while server side render streaming a component.\n" \
+                                        "Original error:\n#{e}\n#{e.backtrace}"
+        end
+
+        barrier.wait
       end
     end
 
-    def process_response_chunks(stream_response, error_body)
-      loop_response_lines(stream_response) do |chunk|
+    # Method to start the decoration
+    def self.create(&request_block)
+      StreamDecorator.new(new(&request_block))
+    end
+
+    private
+
+    def process_response_chunks(stream_response, error_body, &block)
+      parser = ReactOnRails::LengthPrefixedParser.new
+      stream_response.each do |chunk|
+        stream_response.instance_variable_set(:@react_on_rails_received_first_chunk, true)
+
         if response_has_error_status?(stream_response)
           error_body << chunk
           next
         end
 
-        processed_chunk = chunk.strip
-        yield processed_chunk unless processed_chunk.empty?
+        parser.feed(chunk, &block)
       end
+      parser.flush
     end
 
     def response_has_error_status?(response)
@@ -150,34 +172,5 @@ module ReactOnRailsPro
         raise ReactOnRailsPro::Error, "Unexpected response code from renderer: #{response.status}:\n#{error_body}"
       end
     end
-
-    # Method to start the decoration
-    def self.create(&request_block)
-      StreamDecorator.new(new(&request_block))
-    end
-
-    private
-
-    # This method is considered as an override of response.each_line
-    # It fixes the problem of not yielding the last chunk on error
-    # You can check the spec of `each_line` in `spec/react_on_rails_pro/stream_spec.rb` for more details
-    def loop_response_lines(response)
-      return enum_for(__method__, response) unless block_given?
-
-      line = "".b
-
-      response.each do |chunk|
-        response.instance_variable_set(:@react_on_rails_received_first_chunk, true)
-        line << chunk
-
-        while (idx = line.index("\n"))
-          yield line.byteslice(0..idx - 1)
-
-          line = line.byteslice(idx + 1..-1)
-        end
-      end
-    ensure
-      yield line unless line.empty?
-    end
   end
 end

data/lib/react_on_rails_pro/utils.rb

@@ -1,10 +1,6 @@
 # frozen_string_literal: true
 
-# require "English"
-# require "open3"
-# require "rainbow"
-# require "active_support"
-# require "active_support/core_ext/string"
+require "react_on_rails_pro/renderer_cache_path"
 
 module ReactOnRailsPro
   module Utils
@@ -120,10 +116,8 @@ module ReactOnRailsPro
     def self.server_bundle_file_name
       return @server_bundle_hash if @server_bundle_hash && !Rails.env.development?
 
-      @server_bundle_hash = begin
-        server_bundle_name = ReactOnRails.configuration.server_bundle_js_file
-        bundle_file_name(server_bundle_name)
-      end
+      server_bundle_name = ReactOnRails.configuration.server_bundle_js_file
+      @server_bundle_hash = bundle_file_name(server_bundle_name)
     end
 
     def self.calc_bundle_hash(server_bundle_js_file_path)
@@ -179,6 +173,10 @@ module ReactOnRailsPro
       }
     end
 
+    def self.resolve_renderer_cache_dir
+      ReactOnRailsPro::RendererCachePath.resolve
+    end
+
     def self.mine_type_from_file_name(filename)
       extension = File.extname(filename)
       Rack::Mime.mime_type(extension)

data/lib/react_on_rails_pro/version.rb

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

data/lib/react_on_rails_pro.rb

@@ -3,12 +3,16 @@
 require "rails"
 require "react_on_rails"
 
+# Apply HTTPX bug fix for stream_bidi plugin
+require "react_on_rails_pro/httpx_stream_bidi_patch"
+
 require "react_on_rails_pro/request"
 require "react_on_rails_pro/version"
 require "react_on_rails_pro/constants"
 require "react_on_rails_pro/compression_middleware_guard"
 require "react_on_rails_pro/engine"
 require "react_on_rails_pro/error"
+require "react_on_rails_pro/renderer_cache_path"
 require "react_on_rails_pro/utils"
 require "react_on_rails_pro/configuration"
 require "react_on_rails_pro/license_public_key"
@@ -18,8 +22,12 @@ require "react_on_rails_pro/stream_cache"
 require "react_on_rails_pro/server_rendering_pool/pro_rendering"
 require "react_on_rails_pro/server_rendering_pool/node_rendering_pool"
 require "react_on_rails_pro/server_rendering_js_code"
+require "react_on_rails_pro/js_code_builder"
+require "react_on_rails_pro/rendering_strategy/node_strategy"
 require "react_on_rails_pro/assets_precompile"
 require "react_on_rails_pro/prepare_node_renderer_bundles"
+require "react_on_rails_pro/rolling_deploy_cache_stager"
+require "react_on_rails_pro/pre_seed_renderer_cache"
 require "react_on_rails_pro/concerns/stream"
 require "react_on_rails_pro/concerns/rsc_payload_renderer"
 require "react_on_rails_pro/concerns/async_rendering"

data/lib/tasks/assets.rake

@@ -2,10 +2,43 @@
 
 require "active_support"
 
-namespace :react_on_rails_pro do
-  desc "Copy assets to local node-renderer"
+namespace :react_on_rails_pro do # rubocop:disable Metrics/BlockLength
+  desc "Stage the Node Renderer bundle cache. MODE=copy (default; Docker/image builds) " \
+       "or MODE=symlink (dev/CI/same-filesystem deploys)."
+  task pre_seed_renderer_cache: :environment do
+    # Mirrors the guard in `AssetsPrecompile.call`: invoking the staging path against a
+    # non-NodeRenderer setup eventually reaches `pool.server_bundle_hash` and fails with
+    # a low-level error. Abort early with actionable guidance instead.
+    unless ReactOnRailsPro.configuration.node_renderer?
+      abort "[ReactOnRailsPro] react_on_rails_pro:pre_seed_renderer_cache requires the Node Renderer. " \
+            "Set config.server_renderer = \"NodeRenderer\" in your Pro initializer, or remove this task " \
+            "from your deploy pipeline."
+    end
+
+    raw_mode = ENV["MODE"].to_s.downcase
+    raw_mode = "copy" if raw_mode.empty?
+    valid_modes = ReactOnRailsPro::PreSeedRendererCache::VALID_MODES.map(&:to_s)
+    unless valid_modes.include?(raw_mode)
+      abort "[ReactOnRailsPro] Unknown MODE=#{raw_mode.inspect}. " \
+            "Expected one of: #{valid_modes.join(', ')}"
+    end
+    ReactOnRailsPro::PreSeedRendererCache.call(mode: raw_mode.to_sym)
+  end
+
+  # Deprecated alias. Delegates to pre_seed_renderer_cache with MODE=symlink so
+  # existing Procfile/Dockerfile/deploy-script entries keep working during the
+  # deprecation cycle.
+  #
+  # The warning below fires on every task invocation (it is not guarded by the
+  # once-per-process mutex in PrepareNodeRenderBundles). Rake tasks are invoked
+  # once per deploy, so repeated output is not a concern here.
+  desc "DEPRECATED: use 'pre_seed_renderer_cache' (MODE=copy for Docker, MODE=symlink for same-filesystem)."
   task pre_stage_bundle_for_node_renderer: :environment do
-    ReactOnRailsPro::PrepareNodeRenderBundles.call
+    warn "[ReactOnRailsPro] The 'react_on_rails_pro:pre_stage_bundle_for_node_renderer' rake task is deprecated. " \
+         "Migrate to 'rake react_on_rails_pro:pre_seed_renderer_cache' — use MODE=copy (default) for Docker/image " \
+         "builds, or MODE=symlink for same-filesystem deploys (this shim preserves the old symlink behavior). " \
+         "Run 'rake react_on_rails:doctor' for a per-file migration suggestion based on where the task is referenced."
+    ReactOnRailsPro::PreSeedRendererCache.call(mode: :symlink)
   end
 
   desc "Copy assets to remote node-renderer"

data/rakelib/run_rspec.rake

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 # TODO: This file is not used for CI
-require "coveralls/rake/task" if ENV["USE_COVERALLS"] == "TRUE"
 
 require "pathname"
 require "active_support/core_ext/string"
@@ -23,13 +22,15 @@ namespace :run_rspec do
     run_tests_in(spec_dummy_dir)
   end
 
-  desc "(HACK) Run RSpec on spec/empty_spec in order to have SimpleCov generate a coverage report from cache"
+  desc "(HACK) Run RSpec on spec/empty_spec.rb — set COVERAGE=true to generate a SimpleCov report from cache"
   task :empty do
-    sh %(#{ENV['USE_COVERALLS'] ? 'COVERAGE=true' : ''} rspec spec/empty_spec.rb)
+    if ENV["COVERAGE"] == "true"
+      sh "bundle exec rspec spec/empty_spec.rb"
+    else
+      puts "Skipping run_rspec:empty (set COVERAGE=true to generate a SimpleCov report from cache)"
+    end
   end
 
-  Coveralls::RakeTask.new if ENV["USE_COVERALLS"] == "TRUE"
-
   desc "run all tests"
   task run_rspec: %i[gem dummy empty js_tests] do
     puts "Completed all RSpec tests"
@@ -71,7 +72,6 @@ def run_tests_in(dir, options = {})
   command_name = options.fetch(:command_name, path.basename)
   rspec_args = options.fetch(:rspec_args, "")
   env_vars = +"#{options.fetch(:env_vars, '')} TEST_ENV_COMMAND_NAME=\"#{command_name}\""
-  env_vars << "COVERAGE=true" if ENV["USE_COVERALLS"]
   sh_in_dir(path.realpath, "#{env_vars} bundle exec rspec #{rspec_args}")
 end
 

data/react_on_rails_pro.gemspec

@@ -16,9 +16,14 @@ Gem::Specification.new do |s|
 
   s.summary       = "Rails with react server rendering with webpack. Performance helpers"
   s.description   = "See README.md"
-  s.homepage      = "https://github.com/shakacode/react_on_rails_pro"
+  s.homepage      = "https://reactonrails.com/docs/pro/"
   s.license       = "UNLICENSED"
   s.metadata["rubygems_mfa_required"] = "true"
+  s.metadata["bug_tracker_uri"] = "https://github.com/shakacode/react_on_rails/issues"
+  s.metadata["changelog_uri"] = "https://github.com/shakacode/react_on_rails/blob/main/CHANGELOG.md"
+  s.metadata["documentation_uri"] = "https://reactonrails.com/docs/pro/"
+  s.metadata["homepage_uri"] = "https://reactonrails.com/docs/pro/"
+  s.metadata["source_code_uri"] = "https://github.com/shakacode/react_on_rails/tree/main/react_on_rails_pro"
 
   s.files = Dir.chdir(__dir__) do
     `git ls-files -z`.split("\x0").reject do |f|
@@ -32,14 +37,14 @@ Gem::Specification.new do |s|
   s.required_ruby_version = ">= 3.0"
 
   s.add_runtime_dependency "addressable"
+  s.add_runtime_dependency "async", ">= 2.29"
   s.add_runtime_dependency "connection_pool"
   s.add_runtime_dependency "execjs", "~> 2.9"
-  s.add_runtime_dependency "httpx", "~> 1.5"
   # Needed to avoid this bug at httpx versions >= 1.6.0:
   #   https://github.com/HoneyryderChuck/httpx/issues/118
   s.add_runtime_dependency "http-2", ">= 1.1.1"
-  s.add_runtime_dependency "jwt", "~> 2.7"
-  s.add_runtime_dependency "async", ">= 2.29"
+  s.add_runtime_dependency "httpx", "~> 1.5"
+  s.add_runtime_dependency "jwt", ">= 2.7"
   s.add_runtime_dependency "rainbow"
   s.add_runtime_dependency "react_on_rails", ReactOnRails::VERSION
   s.add_development_dependency "bundler"

data/sig/react_on_rails_pro/configuration.rbs

@@ -96,5 +96,7 @@ module ReactOnRailsPro
     def validate_remote_bundle_cache_adapter: () -> void
 
     def setup_renderer_password: () -> void
+
+    def validate_renderer_password_for_production: () -> void
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: react_on_rails_pro
 version: !ruby/object:Gem::Version
-  version: 16.6.0
+  version: 16.7.0.rc.1
 platform: ruby
 authors:
 - Justin Gordon
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-09 00:00:00.000000000 Z
+date: 2026-05-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -25,47 +25,47 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: connection_pool
+  name: async
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.29'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.29'
 - !ruby/object:Gem::Dependency
-  name: execjs
+  name: connection_pool
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.9'
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.9'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: httpx
+  name: execjs
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '2.9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '2.9'
 - !ruby/object:Gem::Dependency
   name: http-2
   requirement: !ruby/object:Gem::Requirement
@@ -81,33 +81,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 1.1.1
 - !ruby/object:Gem::Dependency
-  name: jwt
+  name: httpx
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: '1.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: '1.5'
 - !ruby/object:Gem::Dependency
-  name: async
+  name: jwt
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '2.29'
+        version: '2.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '2.29'
+        version: '2.7'
 - !ruby/object:Gem::Dependency
   name: rainbow
   requirement: !ruby/object:Gem::Requirement
@@ -128,14 +128,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 16.6.0
+        version: 16.7.0.rc.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 16.6.0
+        version: 16.7.0.rc.1
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -228,6 +228,7 @@ files:
 - eslint.config.mjs
 - lib/react_on_rails_pro.rb
 - lib/react_on_rails_pro/assets_precompile.rb
+- lib/react_on_rails_pro/async_props_emitter.rb
 - lib/react_on_rails_pro/async_value.rb
 - lib/react_on_rails_pro/cache.rb
 - lib/react_on_rails_pro/compression_middleware_guard.rb
@@ -238,13 +239,20 @@ files:
 - lib/react_on_rails_pro/constants.rb
 - lib/react_on_rails_pro/engine.rb
 - lib/react_on_rails_pro/error.rb
+- lib/react_on_rails_pro/httpx_stream_bidi_patch.rb
 - lib/react_on_rails_pro/immediate_async_value.rb
+- lib/react_on_rails_pro/js_code_builder.rb
 - lib/react_on_rails_pro/license_public_key.rb
 - lib/react_on_rails_pro/license_task_formatter.rb
 - lib/react_on_rails_pro/license_validator.rb
+- lib/react_on_rails_pro/pre_seed_renderer_cache.rb
 - lib/react_on_rails_pro/prepare_node_renderer_bundles.rb
+- lib/react_on_rails_pro/renderer_cache_helpers.rb
+- lib/react_on_rails_pro/renderer_cache_path.rb
 - lib/react_on_rails_pro/rendering_error.rb
+- lib/react_on_rails_pro/rendering_strategy/node_strategy.rb
 - lib/react_on_rails_pro/request.rb
+- lib/react_on_rails_pro/rolling_deploy_cache_stager.rb
 - lib/react_on_rails_pro/routes.rb
 - lib/react_on_rails_pro/server_rendering_js_code.rb
 - lib/react_on_rails_pro/server_rendering_pool/node_rendering_pool.rb
@@ -276,11 +284,16 @@ files:
 - sig/react_on_rails_pro/immediate_async_value.rbs
 - sig/react_on_rails_pro/license_validator.rbs
 - sig/react_on_rails_pro/utils.rbs
-homepage: https://github.com/shakacode/react_on_rails_pro
+homepage: https://reactonrails.com/docs/pro/
 licenses:
 - UNLICENSED
 metadata:
   rubygems_mfa_required: 'true'
+  bug_tracker_uri: https://github.com/shakacode/react_on_rails/issues
+  changelog_uri: https://github.com/shakacode/react_on_rails/blob/main/CHANGELOG.md
+  documentation_uri: https://reactonrails.com/docs/pro/
+  homepage_uri: https://reactonrails.com/docs/pro/
+  source_code_uri: https://github.com/shakacode/react_on_rails/tree/main/react_on_rails_pro
 post_install_message:
 rdoc_options: []
 require_paths: