react_on_rails_pro 16.4.0.rc.6 → 16.4.0.rc.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d41e1dcb19326994f54698beebb6194a198eb967beea7346b08a376fb86068fd
-  data.tar.gz: 98ca3512787b5d444266eb0cac44420b6a991aab2d928305c8640c752b3981d3
+  metadata.gz: 717ead6ca9b9c1f7354820f063551a8403cabb9fafeb095bd46f35e3d368a483
+  data.tar.gz: 5062b202868b9106090becb6dd5f040761a2dd37ec2a1323053e43df111044ed
 SHA512:
-  metadata.gz: a802fe1da5ebcd4571d4c75d5df49dec8d4894ac298c73e376f31ee34a12faaa0db4b78d137c96932354e366dfbc7ac168c79bcf911721f709e4f5ba52078592
-  data.tar.gz: 31d4f3e670a195d169aa256876a02802341235c439dc9f815f8216c4db8bfbdca933d31acf8e69e845c2e88fa4e897cc49139e89a03a02379eca55acc91735dd
+  metadata.gz: b2fc8c9ad613776be17f834f8a7c2d7ff07b123e6e703b8dd21ffdc4687ee51d0037b49c813c7f7b9596266bfa15885336b1f6ce9df6530e995c68d58557d745
+  data.tar.gz: 025cf054e18a200c61ad22199617ce0374889b1f825290ee13952f02bb993532cf8b1738c0df4a7295c4b9bf576782bf42abe04395f9071dd46b0686697c8c5b

data/CONTRIBUTING.md

@@ -47,12 +47,12 @@ From [How to Write a Git Commit Message](http://chris.beams.io/posts/git-commit/
 ## Doc Changes
 
 When making doc changes, we want the change to work on both [the ShakaCode docs site](https://www.shakacode.com/react-on-rails-pro/docs/) and when browsing the GitHub repo.
-The issue is that the Shakacode site is generated only from files in [`docs`](./docs), so any references from them to non-doc files must use the full GitHub URL.
+The issue is that the ShakaCode site is generated only from files in [`../docs/pro`](../docs/pro), so any references from them to non-doc files must use the full GitHub URL.
 
 ### Links to other docs:
 
 - When making references to doc files, use a relative URL path like:
-  `[Installation Overview](docs/basics/installation-overview.md)`
+  `[Installation Guide](../docs/pro/installation.md)`
 
 - When making references to source code files, use a full url path like:
   `[spec/dummy/config/initializers/react_on_rails.rb](https://github.com/shakacode/react_on_rails/tree/master/react_on_rails_pro/spec/dummy/config/initializers/react_on_rails.rb)`
@@ -119,7 +119,7 @@ script/ci-changes-detector origin/master
 - Push Pro changes without testing locally first
 - Modify both Pro and main gem without running full tests
 
-For comprehensive CI documentation, see [`../docs/contributor-info/ci-optimization.md`](../docs/contributor-info/ci-optimization.md) in the repository root.
+For comprehensive CI documentation, see [`../internal/contributor-info/ci-optimization.md`](../internal/contributor-info/ci-optimization.md) in the repository root.
 
 # IDE/Editor Setup
 
@@ -395,5 +395,5 @@ rake release[17.0.0,false,verdaccio]
 
 For complete documentation, see:
 
-- [Root Release Documentation](../docs/contributor-info/releasing.md)
+- [Root Release Documentation](../internal/contributor-info/releasing.md)
 - Run `rake -D release` for inline help

data/Gemfile.development_dependencies

@@ -8,7 +8,7 @@ git_source(:github) { |repo| "https://github.com/#{repo}.git" }
 
 gem "react_on_rails", path: "../"
 
-gem "shakapacker", "9.5.0"
+gem "shakapacker", "9.6.1"
 gem "bootsnap", require: false
 gem "rails", "~> 7.1"
 gem "puma", "~> 6"

data/Gemfile.lock

@@ -9,7 +9,7 @@ GIT
 PATH
   remote: ..
   specs:
-    react_on_rails (16.4.0.rc.6)
+    react_on_rails (16.4.0.rc.8)
       addressable
       connection_pool
       execjs (~> 2.5)
@@ -20,7 +20,7 @@ PATH
 PATH
   remote: .
   specs:
-    react_on_rails_pro (16.4.0.rc.6)
+    react_on_rails_pro (16.4.0.rc.8)
       addressable
       async (>= 2.6)
       connection_pool
@@ -29,7 +29,7 @@ PATH
       httpx (~> 1.5)
       jwt (~> 2.7)
       rainbow
-      react_on_rails (= 16.4.0.rc.6)
+      react_on_rails (= 16.4.0.rc.8)
 
 GEM
   remote: https://rubygems.org/
@@ -165,7 +165,7 @@ GEM
     drb (2.2.3)
     equivalent-xml (0.6.0)
       nokogiri (>= 1.4.3)
-    erb (6.0.1)
+    erb (6.0.2)
     erubi (1.13.1)
     execjs (2.10.0)
     fakefs (2.8.0)
@@ -194,8 +194,9 @@ GEM
       concurrent-ruby (~> 1.0)
     io-console (0.8.2)
     io-event (1.14.2)
-    irb (1.16.0)
+    irb (1.17.0)
       pp (>= 0.6.0)
+      prism (>= 1.3.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
     jbuilder (2.12.0)
@@ -230,7 +231,8 @@ GEM
     method_source (1.1.0)
     metrics (0.15.0)
     mini_mime (1.1.5)
-    minitest (6.0.1)
+    minitest (6.0.2)
+      drb (~> 2.0)
       prism (~> 1.5)
     mize (0.4.1)
       protocol (~> 2.0)
@@ -247,11 +249,11 @@ GEM
     net-smtp (0.5.1)
       net-protocol
     nio4r (2.7.5)
-    nokogiri (1.19.0-arm64-darwin)
+    nokogiri (1.19.1-arm64-darwin)
       racc (~> 1.4)
-    nokogiri (1.19.0-x86_64-darwin)
+    nokogiri (1.19.1-x86_64-darwin)
       racc (~> 1.4)
-    nokogiri (1.19.0-x86_64-linux-gnu)
+    nokogiri (1.19.1-x86_64-linux-gnu)
       racc (~> 1.4)
     package_json (0.2.0)
     parallel (1.27.0)
@@ -262,7 +264,7 @@ GEM
     pp (0.6.3)
       prettyprint
     prettyprint (0.2.0)
-    prism (1.6.0)
+    prism (1.9.0)
     protocol (2.0.0)
       ruby_parser (~> 3.0)
     pry (0.14.2)
@@ -282,7 +284,7 @@ GEM
     puma (6.5.0)
       nio4r (~> 2.0)
     racc (1.8.1)
-    rack (3.2.4)
+    rack (3.2.5)
     rack-proxy (0.7.7)
       rack
     rack-session (2.1.1)
@@ -310,8 +312,8 @@ GEM
       activesupport (>= 5.0.0)
       minitest
       nokogiri (>= 1.6)
-    rails-html-sanitizer (1.6.2)
-      loofah (~> 2.21)
+    rails-html-sanitizer (1.7.0)
+      loofah (~> 2.25)
       nokogiri (>= 1.15.7, != 1.16.7, != 1.16.6, != 1.16.5, != 1.16.4, != 1.16.3, != 1.16.2, != 1.16.1, != 1.16.0.rc1, != 1.16.0)
     railties (7.2.3)
       actionpack (= 7.2.3)
@@ -330,7 +332,7 @@ GEM
       ffi (~> 1.0)
     rbs (3.9.5)
       logger
-    rdoc (7.1.0)
+    rdoc (7.2.0)
       erb
       psych (>= 4.0.0)
       tsort
@@ -414,9 +416,9 @@ GEM
       rexml (~> 3.2, >= 3.2.5)
       rubyzip (>= 1.2.2, < 3.0)
       websocket (~> 1.0)
-    semantic_range (3.1.0)
+    semantic_range (3.1.1)
     sexp_processor (4.17.1)
-    shakapacker (9.5.0)
+    shakapacker (9.6.1)
       activesupport (>= 5.2)
       package_json
       rack-proxy (>= 0.6.1)
@@ -483,7 +485,7 @@ GEM
     xpath (3.2.0)
       nokogiri (~> 1.8)
     yard (0.9.36)
-    zeitwerk (2.7.4)
+    zeitwerk (2.7.5)
 
 PLATFORMS
   arm64-darwin-24
@@ -531,7 +533,7 @@ DEPENDENCIES
   sass-rails
   scss_lint
   selenium-webdriver (= 4.9.0)
-  shakapacker (= 9.5.0)
+  shakapacker (= 9.6.1)
   spring
   spring-watcher-listen
   sprockets

data/README.md

@@ -156,7 +156,7 @@ end %>
 - Automatic cache invalidation based on props
 - Works with Rails fragment caching infrastructure
 
-**📖 Learn more**: [docs/caching.md](./docs/caching.md)
+**📖 Learn more**: [docs/pro/caching.md](../docs/pro/caching.md)
 
 ### 2. Prerender Caching
 
@@ -175,7 +175,7 @@ end
 - Caches across multiple requests
 - Complements fragment caching for maximum performance
 
-**📖 Learn more**: [docs/caching.md](./docs/caching.md)
+**📖 Learn more**: [docs/pro/caching.md](../docs/pro/caching.md)
 
 ### 3. React on Rails Pro Node Renderer
 
@@ -203,7 +203,7 @@ reactOnRailsProNodeRenderer({
 });
 ```
 
-**📖 Learn more**: [docs/node-renderer/basics.md](./docs/node-renderer/basics.md)
+**📖 Learn more**: [docs/pro/node-renderer/basics.md](../docs/pro/node-renderer/basics.md)
 
 ### 4. React Server Components (RSC)
 
@@ -236,7 +236,7 @@ Speed up webpack rebuilds by caching unchanged bundles.
 - **Faster development**: Hot reload only what changed
 - **Lower costs**: Reduce build server time
 
-**📖 Learn more**: [docs/bundle-caching.md](./docs/bundle-caching.md)
+**📖 Learn more**: [docs/pro/bundle-caching.md](../docs/pro/bundle-caching.md)
 
 ### 6. Global State Management
 
@@ -249,7 +249,7 @@ ReactOnRailsPro.configure do |config|
 end
 ```
 
-**📖 Learn more**: [docs/configuration.md](./docs/configuration.md)
+**📖 Learn more**: [docs/pro/configuration.md](../docs/pro/configuration.md)
 
 ---
 
@@ -326,9 +326,9 @@ rails console
 
 ### Next Steps
 
-- **Enable caching**: See [docs/caching.md](./docs/caching.md)
-- **Set up Node Renderer**: See [docs/node-renderer/basics.md](./docs/node-renderer/basics.md)
-- **Optimize performance**: See [docs/configuration.md](./docs/configuration.md)
+- **Enable caching**: See [docs/pro/caching.md](../docs/pro/caching.md)
+- **Set up Node Renderer**: See [docs/pro/node-renderer/basics.md](../docs/pro/node-renderer/basics.md)
+- **Optimize performance**: See [docs/pro/configuration.md](../docs/pro/configuration.md)
 - **Set up for your team**: See [LICENSE_SETUP.md](./LICENSE_SETUP.md#team-setup)
 
 ---
@@ -337,20 +337,20 @@ rails console
 
 ### Installation & Setup
 
-- **[Installation Guide](./docs/installation.md)** - Detailed installation instructions
+- **[Installation Guide](../docs/pro/installation.md)** - Detailed installation instructions
 - **[License Setup](./LICENSE_SETUP.md)** - Complete license configuration guide
-- **[Configuration Reference](./docs/configuration.md)** - All configuration options
+- **[Configuration Reference](../docs/pro/configuration.md)** - All configuration options
 
 ### Features
 
-- **[Caching Guide](./docs/caching.md)** - Fragment and prerender caching
-- **[Bundle Caching](./docs/bundle-caching.md)** - Speed up webpack builds
-- **[Node Renderer Basics](./docs/node-renderer/basics.md)** - Standalone Node.js server
-- **[Node Renderer Configuration](./docs/node-renderer/js-configuration.md)** - JavaScript config
+- **[Caching Guide](../docs/pro/caching.md)** - Fragment and prerender caching
+- **[Bundle Caching](../docs/pro/bundle-caching.md)** - Speed up webpack builds
+- **[Node Renderer Basics](../docs/pro/node-renderer/basics.md)** - Standalone Node.js server
+- **[Node Renderer Configuration](../docs/pro/node-renderer/js-configuration.md)** - JavaScript config
 
 ### API Reference
 
-- **[Ruby API](./docs/ruby-api.md)** - Helper methods and utilities
+- **[Ruby API](../docs/pro/ruby-api.md)** - Helper methods and utilities
 - **[CHANGELOG](./CHANGELOG.md)** - Version history and upgrade notes
 
 ### Upgrading
@@ -408,7 +408,7 @@ Check out these production applications using React on Rails Pro:
 
 - **📧 Email Support**: [support@shakacode.com](mailto:support@shakacode.com)
 - **💼 Sales & Licensing**: [justin@shakacode.com](mailto:justin@shakacode.com)
-- **📖 Documentation**: [docs/](./docs/)
+- **📖 Documentation**: [docs/pro/](../docs/pro/)
 - **🐛 Found a Bug?**: Email [support@shakacode.com](mailto:support@shakacode.com) (for Pro customers)
 
 ### Professional Services

data/app/helpers/react_on_rails_pro_helper.rb

@@ -314,7 +314,13 @@ module ReactOnRailsProHelper
 
     # Enqueue remaining chunks asynchronously
     @async_barrier.async do
-      rest_chunks.each { |chunk| @main_output_queue.enqueue(chunk) }
+      rest_chunks.each do |chunk|
+        break if response.stream.closed?
+
+        @main_output_queue.enqueue(chunk)
+      end
+    rescue Async::Queue::ClosedError
+      # Queue closed due to error/disconnect in another component — stop enqueuing
     end
 
     # Return first chunk directly
@@ -436,8 +442,8 @@ module ReactOnRailsProHelper
     # Start an async task on the barrier to stream all chunks
     @async_barrier.async do
       stream = yield
-      process_stream_chunks(stream, first_chunk_var, all_chunks)
-      on_complete&.call(all_chunks)
+      fully_consumed = process_stream_chunks(stream, first_chunk_var, all_chunks)
+      on_complete&.call(all_chunks) if fully_consumed
     rescue StandardError => e
       # Propagate the error to the calling fiber via the variable.
       # Async::Variable can only be resolved once — if it was already resolved
@@ -457,9 +463,9 @@ module ReactOnRailsProHelper
       end
     end
 
-    # Wait for and return the first chunk (blocking)
-    first_chunk_var.wait
-    result = first_chunk_var.value
+    # Wait for and return the first chunk (blocking).
+    # Async::Variable#wait blocks until resolved, then returns the stored value.
+    result = first_chunk_var.wait
 
     # If the async task stored an exception (pre-first-chunk error), raise it now.
     # This happens BEFORE response.stream.write(template_string) in
@@ -470,12 +476,17 @@ module ReactOnRailsProHelper
     result
   end
 
+  # Returns true if the stream was fully consumed, false if aborted (client disconnect).
+  # When false, callers must NOT invoke on_complete to avoid caching partial data.
   def process_stream_chunks(stream, first_chunk_var, all_chunks)
     is_first = true
 
     stream.each_chunk do |chunk|
-      # Check if client disconnected before processing chunk
-      break if response.stream.closed?
+      # Client disconnected — abort without caching partial results
+      if response.stream.closed?
+        first_chunk_var.value = nil if is_first
+        return false
+      end
 
       all_chunks&.push(chunk)
 
@@ -491,6 +502,7 @@ module ReactOnRailsProHelper
 
     # Handle case where stream has no chunks
     first_chunk_var.value = nil if is_first
+    true
   end
 
   def internal_stream_react_component(component_name, options = {})

data/lib/react_on_rails_pro/concerns/rsc_payload_renderer.rb

@@ -15,7 +15,22 @@ module ReactOnRailsPro
 
       stream_view_containing_react_components(
         template: custom_rsc_payload_template,
-        layout: false
+        layout: false,
+        # Render as text so Rails does not inject HTML view annotation comments
+        # into the NDJSON stream. Custom template overrides must resolve to a
+        # text or format-neutral template, not `.html.erb`.
+        formats: [:text],
+        content_type: "application/x-ndjson"
+      )
+    rescue ActionView::MissingTemplate => e
+      raise e.exception(
+        "[React on Rails Pro] RSC payload templates are now rendered with format :text. " \
+        "If you override `custom_rsc_payload_template`, make sure the override resolves to " \
+        "a text or format-neutral template (for example `rsc_payload.text.erb`) instead of " \
+        "only `.html.erb`. See\n" \
+        "https://github.com/shakacode/react_on_rails/blob/master/docs/pro/updating.md " \
+        "for upgrade notes.\n\n" \
+        "Original error: #{e.message}"
       )
     end
 

data/lib/react_on_rails_pro/concerns/stream.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "English"
+
 module ReactOnRailsPro
   module Stream
     extend ActiveSupport::Concern
@@ -12,6 +14,10 @@ module ReactOnRailsPro
     #
     # @param template [String] The path to the template file to be streamed.
     # @param close_stream_at_end [Boolean] Whether to automatically close the stream after rendering (default: true).
+    # @param content_type [String, nil] Optional response content type. Set after rendering but before the first
+    #   stream write, overriding any content type inferred from the template format. When using
+    #   a non-HTML `formats:` value (for example `[:text]`), pass `content_type` too unless
+    #   committing the format-derived MIME type is intentional.
     # @param render_options [Hash] Additional options to pass to `render_to_string`.
     #
     # components must be added to the view using the `stream_react_component` helper.
@@ -30,10 +36,13 @@ module ReactOnRailsPro
     #       For more details, refer to `lib/react_on_rails/helper.rb` in the react_on_rails repository.
     #
     # @see ReactOnRails::Helper#stream_react_component
-    def stream_view_containing_react_components(template:, close_stream_at_end: true, **render_options)
+    def stream_view_containing_react_components(
+      template:, close_stream_at_end: true, content_type: nil, **render_options
+    )
       require "async"
       require "async/barrier"
       require "async/limited_queue"
+      warn_on_non_html_formats_without_content_type(render_options[:formats], content_type)
 
       Sync do |parent_task|
         # Initialize async primitives for concurrent component streaming
@@ -48,6 +57,11 @@ module ReactOnRailsPro
         # View may contain extra newlines, chunk already contains a newline
         # Having multiple newlines between chunks causes hydration errors
         # So we strip extra newlines from the template string and add a single newline
+        # `formats: [:text]` causes render_to_string to set response.content_type
+        # to `text/plain`; override it here before the first stream write, which
+        # is when ActionController::Live commits headers. render_to_string itself
+        # never writes to response.stream, so this assignment is always safe.
+        response.content_type = content_type if content_type
         response.stream.write(template_string)
 
         drain_streams_concurrently(parent_task)
@@ -80,8 +94,6 @@ module ReactOnRailsPro
     # - Barrier is stopped to cancel all producer tasks, preventing wasted work
     # - No exception propagates to the controller for client disconnects
     def drain_streams_concurrently(parent_task)
-      client_disconnected = false
-
       writing_task = parent_task.async do
         # Drain all remaining chunks from the queue to the response stream
         while (chunk = @main_output_queue.dequeue)
@@ -89,8 +101,13 @@ module ReactOnRailsPro
         end
       rescue IOError, Errno::EPIPE => e
         # Client disconnected - stop writing gracefully
-        client_disconnected = true
         log_client_disconnect("writer", e)
+      ensure
+        # Cancel all producers when writer exits for ANY reason (normal completion,
+        # client disconnect, or unexpected error). Prevents deadlock where producers
+        # block on enqueue to a full queue that nobody is consuming.
+        # Idempotent — no-op if barrier tasks already completed.
+        @async_barrier.stop
       end
 
       # Wait for all component streaming tasks to complete
@@ -101,16 +118,22 @@ module ReactOnRailsPro
         raise e
       end
     ensure
-      # Close the queue first to unblock writing_task (it may be waiting on dequeue)
-      @main_output_queue.close
+      # Capture the primary exception (if any) BEFORE any cleanup that could raise.
+      # In an ensure block, $ERROR_INFO holds the exception currently propagating
+      # out of the method (nil if returning normally). We must snapshot it before
+      # the begin/rescue below, where $ERROR_INFO would reflect the caught exception.
+      primary_exception = $ERROR_INFO
 
-      # Wait for writing_task to ensure client_disconnected flag is set
-      # before we check it (fixes race condition where ensure runs before
-      # writing_task's rescue block sets the flag)
-      writing_task.wait
+      # Close the queue to unblock writing_task (it may be waiting on dequeue)
+      @main_output_queue.close
 
-      # If client disconnected, stop all producer tasks to avoid wasted work
-      @async_barrier.stop if client_disconnected
+      # Wait for writing_task to finish. Wrap in rescue to avoid masking a primary
+      # exception (e.g., producer error) with a secondary writing_task exception.
+      begin
+        writing_task.wait
+      rescue StandardError
+        raise unless primary_exception
+      end
     end
 
     def log_client_disconnect(context, exception)
@@ -120,5 +143,19 @@ module ReactOnRailsPro
         "[React on Rails Pro] Client disconnected during streaming (#{context}): #{exception.class}"
       end
     end
+
+    def warn_on_non_html_formats_without_content_type(formats, content_type)
+      return if content_type.present?
+
+      requested_formats = Array(formats).compact.map(&:to_sym)
+      return if requested_formats.empty? || requested_formats.all?(:html)
+
+      Rails.logger.warn(
+        "[React on Rails Pro] stream_view_containing_react_components received non-HTML formats " \
+        "#{requested_formats.inspect} without `content_type:`. Rails will commit the format-derived " \
+        "MIME type (for example `text/plain` for `:text`). Pass `content_type:` explicitly when " \
+        "streaming non-HTML responses."
+      )
+    end
   end
 end

data/lib/react_on_rails_pro/engine.rb

@@ -7,8 +7,10 @@ module ReactOnRailsPro
     LICENSE_URL = "https://www.shakacode.com/react-on-rails-pro/"
     # TODO: Remove this legacy migration warning path after 16.5.0 stable release (target: 2026-05-31).
     LEGACY_LICENSE_FILE = "config/react_on_rails_pro_license.key"
+    RSC_STREAMING_MIDDLEWARE_WARNING_TARGETS = ["Rack::Deflater"].freeze
     private_constant :LICENSE_URL
     private_constant :LEGACY_LICENSE_FILE
+    private_constant :RSC_STREAMING_MIDDLEWARE_WARNING_TARGETS
 
     initializer "react_on_rails_pro.routes" do
       ActionDispatch::Routing::Mapper.include ReactOnRailsPro::Routes
@@ -20,6 +22,10 @@ module ReactOnRailsPro
       config.after_initialize { ReactOnRailsPro::Engine.log_license_status }
     end
 
+    initializer "react_on_rails_pro.check_rsc_streaming_middleware" do
+      config.after_initialize { ReactOnRailsPro::Engine.log_rsc_streaming_middleware_warning }
+    end
+
     class << self
       def log_license_status
         status = ReactOnRailsPro::LicenseValidator.license_status
@@ -40,6 +46,24 @@ module ReactOnRailsPro
         end
       end
 
+      def log_rsc_streaming_middleware_warning
+        return unless ReactOnRailsPro.configuration.enable_rsc_support
+        return if Rails.env.test?
+
+        middleware_names = middleware_stack_names
+        problematic = RSC_STREAMING_MIDDLEWARE_WARNING_TARGETS & middleware_names
+        return if problematic.empty?
+
+        route_path = ReactOnRailsPro.configuration.rsc_payload_generation_url_path
+        Rails.logger.warn(
+          "[React on Rails Pro] React Server Components support is enabled and the middleware " \
+          "stack includes #{problematic.join(', ')}. Compression and other response-transforming " \
+          "middleware can interfere with ActionController::Live NDJSON streaming. If your " \
+          "`#{route_path}` payload route is not already exempt, consider bypassing " \
+          "#{problematic.join(', ')} for that endpoint if you see stalled or corrupted RSC payloads."
+        )
+      end
+
       private
 
       def log_valid_license
@@ -105,6 +129,40 @@ module ReactOnRailsPro
           Rails.logger.info message
         end
       end
+
+      def middleware_stack_names
+        middleware_stack = Rails.application&.middleware
+        return [] unless middleware_stack
+
+        entries =
+          if middleware_stack.respond_to?(:middlewares)
+            middleware_stack.middlewares
+          elsif middleware_stack.respond_to?(:to_a)
+            middleware_stack.to_a
+          else
+            Array(middleware_stack)
+          end
+
+        entries.filter_map { |entry| middleware_entry_name(entry) }.uniq
+      end
+
+      def middleware_entry_name(entry)
+        candidate =
+          if entry.respond_to?(:klass) && entry.klass
+            entry.klass
+          elsif entry.is_a?(Array)
+            entry.first
+          else
+            entry
+          end
+
+        case candidate
+        when Module
+          candidate.name
+        else
+          candidate.to_s.presence
+        end
+      end
     end
   end
 end

data/lib/react_on_rails_pro/request.rb

@@ -319,6 +319,16 @@ module ReactOnRailsPro
           end
 
           response = HTTPX.get(path)
+          error = response.error
+          if error
+            # Re-raise via rescue so Ruby sets error.cause for exception chaining.
+            begin
+              raise error
+            rescue StandardError
+              raise ReactOnRailsPro::Error, "Failed to fetch dev-server asset from #{path}: #{error}"
+            end
+          end
+
           response.body
         else
           Pathname.new(path)

data/lib/react_on_rails_pro/stream_request.rb

@@ -113,7 +113,7 @@ module ReactOnRailsPro
 
     def process_response_chunks(stream_response, error_body)
       loop_response_lines(stream_response) do |chunk|
-        if stream_response.is_a?(HTTPX::ErrorResponse) || stream_response.status >= 400
+        if response_has_error_status?(stream_response)
           error_body << chunk
           next
         end
@@ -123,6 +123,15 @@ module ReactOnRailsPro
       end
     end
 
+    def response_has_error_status?(response)
+      return true if response.is_a?(HTTPX::ErrorResponse)
+
+      response.status >= 400
+    rescue NoMethodError
+      # HTTPX::StreamResponse can fail to delegate #status for non-streaming errors.
+      true
+    end
+
     def handle_http_error(error, error_body, send_bundle)
       response = error.response
       case response.status

data/lib/react_on_rails_pro/version.rb

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