react_on_rails_pro 16.6.0 → 16.7.0.rc.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 91309f642414eae0ab09407243def617e7f32b2b9db0d0b62b108984d31b41e0
-  data.tar.gz: 1dec0600d12b121c3bbe62390a0c36124efed1fe40a5a53b0485d6b74e764a25
+  metadata.gz: c4063509561a2dee0f173ad74812beea1ae6014f59388e29d54299b0a4644071
+  data.tar.gz: 84ac0c7d8c79a65f42e3651c543d74723662001584df47bb4923cceca2e4c10d
 SHA512:
-  metadata.gz: 32a8382d7d10c90e475ebcd76607e6716b1e73766c228bb43362a33ca8223efd9cd5470a1c012cc82ec1c957356047351c35e988daed3f27e1a552cde7108a32
-  data.tar.gz: 7096efd3fb7dfe712b14f116977b9827594ae7b6505e90842f5d2213c564efc67a890fa7051c53c4373a10e303e35adee23dc27caf95f0cd68e91c70de1d57de
+  metadata.gz: f37225bab9df92d9fa7dbc9bd136b88daedf9f913f0fae2cd46f0ab16bc7362a4e9060bf8e0cd81b5ecb39bf8ef6ffd262572afda5a3fa962cc7f1168a0b352e
+  data.tar.gz: a466711a910920add21ce39477319a8ab9cd94e94bf9e75f04dbbfdfefaae891fb7d6fb3e024efd1db0c7f5756273ac87dc2a613c744c82743fcef08b7b3c2da

data/.controlplane/rails.yml

@@ -20,7 +20,7 @@ spec:
           protocol: http
     - name: node-renderer
       args:
-        - client/node-renderer.js
+        - renderer/node-renderer.js
       command: node
       cpu: 512m
       env:
@@ -46,4 +46,4 @@ spec:
         - 0.0.0.0/0
       # Could configure outbound for more security
       outboundAllowCIDR:
-        - 0.0.0.0/0
+        - 0.0.0.0/0

data/CLAUDE.md

@@ -58,6 +58,16 @@ The node renderer is a standalone Fastify HTTP server (separate Node.js process)
 - Integrations: Sentry, Honeybadger (optional peer deps)
 - Protocol versioning: `protocolVersion` in package.json must match gem expectations
 
+**Validating source changes against the dummy app:** the dummy consumes the _built_
+`packages/react-on-rails-pro-node-renderer/lib/**`, so edits under `src/**` are not
+picked up until the package is rebuilt. Use one of:
+
+- `pnpm --filter react-on-rails-pro-node-renderer run build` (one-shot)
+- `cd react_on_rails_pro/spec/dummy && pnpm run node-renderer:fresh` (rebuild + start)
+- `pnpm --filter react-on-rails-pro-node-renderer run build-watch` (watch in another shell)
+
+See `.claude/docs/validating-node-renderer-changes.md` for the full checklist.
+
 ### Yalc Dependency Chain
 
 Pro dummy's preinstall builds and links packages in this order:

data/CONTRIBUTING.md

@@ -55,7 +55,7 @@ For links from docs pages to non-doc files, use full GitHub URLs so links resolv
   `[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/main/react_on_rails_pro/spec/dummy/config/initializers/react_on_rails.rb)`
+  `[spec/dummy/config/initializers/react_on_rails.rb](https://github.com/shakacode/react_on_rails/blob/main/react_on_rails_pro/spec/dummy/config/initializers/react_on_rails.rb)`
 
 ## To run tests:
 
@@ -347,7 +347,7 @@ bundle exec rspec
 
 If you run `rspec` at the top level, you'll see this message: `require': cannot load such file -- rails_helper (LoadError)`
 
-After running a test, you can view the coverage results in SimpleCov reports by opening `coverage/index.html`.
+If you run tests with `COVERAGE=true`, you can view the SimpleCov report at `coverage/index.html`.
 
 ### Debugging
 

data/Gemfile.development_dependencies

@@ -33,32 +33,39 @@ gem "amazing_print"
 
 group :development do
   # Access an interactive console on exception pages or by calling 'console' anywhere in the code.
-  gem 'web-console'
-  gem 'listen'
+  gem "web-console"
+  gem "listen"
   # Spring speeds up development by keeping your application running in the background. Read more: https://github.com/rails/spring
-  gem 'spring'
-  gem 'spring-watcher-listen'
+  gem "spring"
+  gem "spring-watcher-listen"
 end
 
 group :development, :test do
-  gem 'faker'
-  gem 'graphiql-rails'
-  gem 'pry', '>= 0.14.1' # Console with powerful introspection capabilities
+  gem "faker"
+  gem "graphiql-rails"
+  gem "pry", ">= 0.14.1" # Console with powerful introspection capabilities
   # Need to use master of pry-byebug to use latest pry version
-  gem 'pry-byebug', github: 'shakacode/pry-byebug' # Integrates pry with byebug
-  gem 'pry-doc' # Provide MRI Core documentation
-  gem 'pry-rails' # Causes rails console to open pry. `DISABLE_PRY_RAILS=1 rails c` can still open with IRB
-  gem 'pry-theme' # An easy way to customize Pry colors via theme files
+  # Loaded manually in spec_helper.rb so specs can boot on readline-less Ruby builds.
+  gem "pry-byebug", github: "shakacode/pry-byebug", require: false # Integrates pry with byebug
+  gem "pry-doc" # Provide MRI Core documentation
+  gem "pry-rails" # Causes rails console to open pry. `DISABLE_PRY_RAILS=1 rails c` can still open with IRB
+  gem "pry-theme" # An easy way to customize Pry colors via theme files
 
   gem "rbs", require: false
   gem "scss_lint", require: false
-  gem 'fakefs', require: 'fakefs/safe'
+  gem "fakefs", require: "fakefs/safe"
+
+  # Ruby 3.5+ removed these from the default gem set; they must now be declared explicitly
+  # to avoid `cannot load such file` errors from gems that lazy-require them (e.g. jbuilder).
+  gem "benchmark", require: false
+  gem "logger", require: false
+  gem "ostruct", require: false
 end
 
 group :test do
   gem "capybara", ">= 3.38.0"
   gem "capybara-screenshot"
-  gem "coveralls", require: false
+  gem "simplecov", "~> 0.16.1", require: false
   gem "equivalent-xml"
   gem "generator_spec"
   gem "launchy"

data/Gemfile.lock

@@ -9,7 +9,7 @@ GIT
 PATH
   remote: ..
   specs:
-    react_on_rails (16.6.0)
+    react_on_rails (16.7.0.rc.0)
       addressable
       connection_pool
       execjs (~> 2.5)
@@ -20,16 +20,16 @@ PATH
 PATH
   remote: .
   specs:
-    react_on_rails_pro (16.6.0)
+    react_on_rails_pro (16.7.0.rc.0)
       addressable
       async (>= 2.29)
       connection_pool
       execjs (~> 2.9)
       http-2 (>= 1.1.1)
       httpx (~> 1.5)
-      jwt (~> 2.7)
+      jwt (>= 3.2.0)
       rainbow
-      react_on_rails (= 16.6.0)
+      react_on_rails (= 16.7.0.rc.0)
 
 GEM
   remote: https://rubygems.org/
@@ -149,12 +149,6 @@ GEM
       fiber-annotation
       fiber-local (~> 1.1)
       json
-    coveralls (0.8.23)
-      json (>= 1.8, < 3)
-      simplecov (~> 0.16.1)
-      term-ansicolor (~> 1.3)
-      thor (>= 0.19.4, < 2.0)
-      tins (~> 1.6)
     crack (1.0.0)
       bigdecimal
       rexml
@@ -188,7 +182,7 @@ GEM
       railties
     hashdiff (1.1.0)
     http-2 (1.1.1)
-    httpx (1.6.3)
+    httpx (1.7.0)
       http-2 (>= 1.0.0)
     i18n (1.14.8)
       concurrent-ruby (~> 1.0)
@@ -207,7 +201,7 @@ GEM
       railties (>= 4.2.0)
       thor (>= 0.14, < 2.0)
     json (2.17.1)
-    jwt (2.10.2)
+    jwt (3.2.0)
       base64
     language_server-protocol (3.17.0.5)
     launchy (3.0.1)
@@ -234,8 +228,6 @@ GEM
     minitest (6.0.2)
       drb (~> 2.0)
       prism (~> 1.5)
-    mize (0.4.1)
-      protocol (~> 2.0)
     msgpack (1.7.2)
     net-http (0.4.1)
       uri
@@ -255,6 +247,7 @@ GEM
       racc (~> 1.4)
     nokogiri (1.19.2-x86_64-linux-gnu)
       racc (~> 1.4)
+    ostruct (0.6.3)
     package_json (0.2.0)
     parallel (1.27.0)
     parser (3.3.10.0)
@@ -265,8 +258,6 @@ GEM
       prettyprint
     prettyprint (0.2.0)
     prism (1.9.0)
-    protocol (2.0.0)
-      ruby_parser (~> 3.0)
     pry (0.14.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
@@ -390,9 +381,6 @@ GEM
     rubocop-rspec_rails (2.29.1)
       rubocop (~> 1.61)
     ruby-progressbar (1.13.0)
-    ruby_parser (3.21.0)
-      racc (~> 1.5)
-      sexp_processor (~> 4.16)
     rubyzip (2.3.2)
     sass (3.7.4)
       sass-listen (~> 4.0.0)
@@ -417,7 +405,6 @@ GEM
       rubyzip (>= 1.2.2, < 3.0)
       websocket (~> 1.0)
     semantic_range (3.1.1)
-    sexp_processor (4.17.1)
     shakapacker (9.6.1)
       activesupport (>= 5.2)
       package_json
@@ -444,16 +431,9 @@ GEM
     sqlite3 (2.9.2-x86_64-darwin)
     sqlite3 (2.9.2-x86_64-linux-gnu)
     stringio (3.2.0)
-    sync (0.5.0)
-    term-ansicolor (1.10.2)
-      mize
-      tins (~> 1.0)
     thor (1.5.0)
     tilt (2.4.0)
     timeout (0.4.4)
-    tins (1.33.0)
-      bigdecimal
-      sync
     traces (0.18.2)
     tsort (0.2.0)
     turbolinks (5.2.1)
@@ -488,6 +468,7 @@ GEM
     zeitwerk (2.7.5)
 
 PLATFORMS
+  arm64-darwin-23
   arm64-darwin-24
   arm64-darwin-25
   x86_64-darwin-24
@@ -495,12 +476,12 @@ PLATFORMS
 
 DEPENDENCIES
   amazing_print
+  benchmark
   bootsnap
   bundler
   capybara (>= 3.38.0)
   capybara-screenshot
   commonmarker
-  coveralls
   equivalent-xml
   fakefs
   faker
@@ -511,9 +492,11 @@ DEPENDENCIES
   jquery-rails
   launchy
   listen
+  logger
   net-http
   net-imap
   net-smtp
+  ostruct
   pg
   pry (>= 0.14.1)
   pry-byebug!
@@ -535,6 +518,7 @@ DEPENDENCIES
   scss_lint
   selenium-webdriver (= 4.9.0)
   shakapacker (= 9.6.1)
+  simplecov (~> 0.16.1)
   spring
   spring-watcher-listen
   sprockets

data/Rakefile

@@ -3,11 +3,6 @@
 # Rake will automatically load any *.rake files inside of the "rakelib" folder
 # See rakelib/
 tasks = %w[run_rspec lint]
-if ENV["USE_COVERALLS"] == "TRUE"
-  require "coveralls/rake/task"
-  Coveralls::RakeTask.new
-  tasks << "coveralls:push"
-end
 
 desc "Run all tests and linting"
 task default: tasks

data/app/helpers/react_on_rails_pro_helper.rb

@@ -141,6 +141,30 @@ module ReactOnRailsProHelper
     end
   end
 
+  def stream_react_component_with_async_props(component_name, options = {}, &props_block)
+    unless ReactOnRailsPro.configuration.enable_rsc_support
+      raise ReactOnRailsPro::Error,
+            "stream_react_component_with_async_props requires enable_rsc_support to be true. " \
+            "Async props depend on React Server Components. " \
+            "Set `config.enable_rsc_support = true` in your ReactOnRailsPro configuration."
+    end
+
+    options[:async_props_block] = props_block
+    stream_react_component(component_name, options)
+  end
+
+  def rsc_payload_react_component_with_async_props(component_name, options = {}, &props_block)
+    unless ReactOnRailsPro.configuration.enable_rsc_support
+      raise ReactOnRailsPro::Error,
+            "rsc_payload_react_component_with_async_props requires enable_rsc_support to be true. " \
+            "Async props depend on React Server Components. " \
+            "Set `config.enable_rsc_support = true` in your ReactOnRailsPro configuration."
+    end
+
+    options[:async_props_block] = props_block
+    rsc_payload_react_component(component_name, options)
+  end
+
   # Renders the React Server Component (RSC) payload for a given component. This helper generates
   # a special format designed by React for serializing server components and transmitting them
   # to the client.
@@ -516,7 +540,10 @@ module ReactOnRailsProHelper
     render_options = create_render_options(react_component_name, options)
     json_stream = server_rendered_react_component(render_options)
     json_stream.transform do |chunk|
-      "#{chunk.to_json}\n".html_safe
+      html = chunk.delete("html") || ""
+      metadata = chunk.to_json
+      content_bytes = html.bytesize.to_s(16).rjust(8, "0")
+      "#{metadata}\t#{content_bytes}\n#{html}".html_safe
     end
   end
 

data/lib/react_on_rails_pro/assets_precompile.rb

@@ -1,9 +1,15 @@
 # frozen_string_literal: true
 
+require "timeout"
+
 module ReactOnRailsPro
   class AssetsPrecompile # rubocop:disable Metrics/ClassLength
     include Singleton
 
+    # Per-hash upload budget during assets:precompile. With RSC enabled this can
+    # be spent twice per deploy (server bundle + RSC bundle).
+    UPLOAD_TIMEOUT_SECONDS = 120
+
     def remote_bundle_cache_adapter
       unless ReactOnRailsPro.configuration.remote_bundle_cache_adapter.is_a?(Module)
         raise ReactOnRailsPro::Error, "config.remote_bundle_cache_adapter must have a module assigned"
@@ -62,9 +68,172 @@ module ReactOnRailsPro
 
     def self.call
       instance.build_or_fetch_bundles
+      return unless ReactOnRailsPro.configuration.node_renderer?
+
+      # Symlink is the same-filesystem default (local dev, CI, Heroku-style same-dyno
+      # deploys, bundle-caching restores). Docker image builds that run assets:precompile
+      # should set ASSETS_PRECOMPILE_RENDERER_CACHE_MODE=copy to bake the cache into the
+      # immutable artifact, or invoke `rake react_on_rails_pro:pre_seed_renderer_cache`
+      # directly (which defaults to copy mode).
+      ReactOnRailsPro::PreSeedRendererCache.call(mode: pre_seed_renderer_cache_mode)
+
+      publish_current_bundle_if_configured
+    end
+
+    # Best-effort publication of the just-built bundles + assets to the configured
+    # rolling_deploy_adapter so that the *next* deploy can fetch these hashes as
+    # "previous" bundles. Runs only in production-like environments. Errors are
+    # warned per-hash, not raised, because a failed upload degrades the next
+    # deploy's rolling-deploy seeding — not this deploy's correctness.
+    #
+    # Protocol: each hash is one bundle's cache entry — when RSC is enabled,
+    # upload is called once for the server bundle (under server_bundle_hash)
+    # and once for the RSC bundle (under rsc_bundle_hash).
+    def self.publish_current_bundle_if_configured
+      adapter = ReactOnRailsPro.configuration.rolling_deploy_adapter
+      return if adapter.nil?
+      # NodeRendererPool.server_bundle_hash is only available under the NodeRenderer
+      # renderer mode. With ExecJS, skip publication rather than crash.
+      return unless ReactOnRailsPro.configuration.node_renderer?
+      return if Rails.env.development? || Rails.env.test?
+
+      publish_bundles(adapter)
+    rescue StandardError => e
+      # Outer rescue catches anything raised by the setup-side calls below
+      # (collect_assets, server_bundle_hash, rsc_bundle_js_file_path). Per the
+      # rolling-deploy contract, a failed upload must degrade the next deploy's
+      # seeding — not fail *this* deploy's assets:precompile.
+      warn "[ReactOnRailsPro] rolling_deploy_adapter publication failed: #{e.class}: #{e.message}. " \
+           "Next deploy's rolling-deploy seeding may degrade; precompile continuing."
+    end
+
+    def self.publish_bundles(adapter)
+      pool = ReactOnRailsPro::ServerRenderingPool::NodeRenderingPool
+      # Companion manifests are generated for the deploy as a whole, so server
+      # and RSC hashes from the same build intentionally share this asset set.
+      assets = filter_existing_assets(ReactOnRailsPro::RendererCacheHelpers.collect_assets.map(&:to_s))
 
-      ReactOnRailsPro::PrepareNodeRenderBundles.call if ReactOnRailsPro.configuration.node_renderer?
+      # Defer the hash computation behind a block: `bundle_hash` reads the bundle
+      # file (`File.mtime` in dev/test, `Digest::MD5.file` for non-content-hashed
+      # names), so evaluating it eagerly as an argument would let a missing
+      # bundle raise and bypass the per-bundle warning path.
+      server_bundle = ReactOnRails::Utils.server_bundle_js_file_path
+      publish_bundle_if_present(adapter, server_bundle, assets, "server") { pool.server_bundle_hash }
+
+      return unless ReactOnRailsPro.configuration.enable_rsc_support
+
+      rsc_bundle = ReactOnRailsPro::Utils.rsc_bundle_js_file_path
+      publish_bundle_if_present(adapter, rsc_bundle, assets, "RSC") { pool.rsc_bundle_hash }
+    end
+
+    # Some collected companion assets may be absent or point at non-file paths.
+    # Typical adapters iterate the list and `cp`/open each entry, so forwarding
+    # an invalid path would raise and abort the whole hash upload, leaving the
+    # next deploy unable to fetch this hash (→ cold 410 retries). Drop invalid
+    # entries with a warning so publication still covers the existing assets.
+    #
+    # Mirrors RendererCacheHelpers.each_stageable_asset: skip URL-backed assets
+    # (dev server) and expand relative paths against Rails.root before checking
+    # existence. Without the expansion, `assets:precompile` invoked from a
+    # non-Rails.root cwd would silently drop relative entries in `assets_to_copy`.
+    def self.filter_existing_assets(assets)
+      resolvable = assets.reject { |path| ReactOnRailsPro::RendererCacheHelpers.http_url?(path) }
+      resolved = resolvable.map { |path| File.expand_path(path.to_s, Rails.root) }
+
+      existing, invalid = resolved.partition { |path| File.file?(path) }
+      return existing if invalid.empty?
+
+      missing, non_files = invalid.partition { |path| !File.exist?(path) }
+      warn_skipped_invalid_assets(existing, missing, non_files)
+      warn_if_unavailable_required_rsc_assets(invalid)
+      existing
+    end
+
+    # Combine missing-vs-non-file reasons into a single warning so operators see
+    # one entry per skipped batch instead of two near-identical lines. The
+    # reason breakdown (missing vs non-file) still appears so adapter authors
+    # can tell a deleted asset apart from one that resolved to e.g. a directory.
+    def self.warn_skipped_invalid_assets(existing, missing, non_files)
+      reasons = []
+      reasons << "missing: #{missing.inspect}" unless missing.empty?
+      reasons << "not a file: #{non_files.inspect}" unless non_files.empty?
+      warn "[ReactOnRailsPro] Skipping invalid assets for rolling_deploy_adapter upload " \
+           "(some may be required for RSC) — #{reasons.join('; ')}. " \
+           "Continuing with #{existing.length} existing asset(s)."
+    end
+
+    # Match by full expanded path (filter_existing_assets passes expanded paths
+    # in `unavailable_assets`) rather than basename, so an unrelated missing
+    # entry in `assets_to_copy` that happens to share a basename with a required
+    # RSC manifest can't false-positive this warning when the real required
+    # file is present elsewhere.
+    def self.warn_if_unavailable_required_rsc_assets(unavailable_assets)
+      required_paths = ReactOnRailsPro::RendererCacheHelpers.required_rsc_asset_paths_for_current_config
+      missing_required_paths = unavailable_assets.select { |path| required_paths.include?(path) }
+      return if missing_required_paths.empty?
+
+      missing_required = missing_required_paths.map { |path| File.basename(path) }
+      warn "[ReactOnRailsPro] WARNING: unavailable assets include required RSC companion file(s) " \
+           "#{missing_required.inspect}. The partial entry will be rejected on every subsequent rolling " \
+           "deploy that tries to seed this bundle hash for RSC (falling back to 410-retry) until a " \
+           "complete precompile with all required RSC companion files overwrites this hash."
+    end
+
+    def self.publish_bundle(adapter, hash, bundle, assets, bundle_label)
+      if hash.to_s.empty?
+        warn "[ReactOnRailsPro] Skipping rolling_deploy_adapter publication for #{bundle_label} bundle " \
+             "#{bundle.inspect} because its bundle hash is blank."
+        return
+      end
+
+      upload_bundle(adapter, hash, bundle, assets)
+    end
+
+    def self.publish_bundle_if_present(adapter, bundle, assets, bundle_label)
+      if File.file?(bundle)
+        publish_bundle(adapter, yield, bundle, assets, bundle_label)
+      else
+        display_label = bundle_label == "RSC" ? "RSC" : bundle_label.capitalize
+        reason = File.exist?(bundle) ? "is not a file" : "does not exist"
+        # Use `bundle_label` (the caller's original casing) for the second
+        # reference so the warning reads consistently (e.g. "RSC bundle ...
+        # skipping ... for RSC bundle" rather than mixing "RSC" and "rsc").
+        warn "[ReactOnRailsPro] #{display_label} bundle #{bundle.inspect} #{reason}; " \
+             "skipping rolling_deploy_adapter publication for #{bundle_label} bundle."
+      end
+    end
+
+    def self.upload_bundle(adapter, hash, bundle, assets)
+      Timeout.timeout(UPLOAD_TIMEOUT_SECONDS) do
+        adapter.upload(hash, bundle: bundle, assets: assets)
+      end
+      puts "[ReactOnRailsPro] Published bundle hash #{hash} via rolling_deploy_adapter"
+    rescue Timeout::Error
+      warn "[ReactOnRailsPro] rolling_deploy_adapter#upload for #{hash} timed out after " \
+           "#{UPLOAD_TIMEOUT_SECONDS}s. Next deploy's rolling-deploy seeding for this hash may degrade."
+    rescue StandardError => e
+      warn "[ReactOnRailsPro] rolling_deploy_adapter#upload for #{hash} raised #{e.class}: " \
+           "#{e.message}. Next deploy's rolling-deploy seeding for this hash may degrade."
+    end
+    private_class_method :publish_current_bundle_if_configured,
+                         :publish_bundles,
+                         :filter_existing_assets,
+                         :warn_skipped_invalid_assets,
+                         :warn_if_unavailable_required_rsc_assets,
+                         :publish_bundle,
+                         :publish_bundle_if_present,
+                         :upload_bundle
+
+    def self.pre_seed_renderer_cache_mode
+      raw = ENV.fetch("ASSETS_PRECOMPILE_RENDERER_CACHE_MODE", "symlink").to_s.downcase
+      mode = raw.to_sym
+      return mode if ReactOnRailsPro::PreSeedRendererCache::VALID_MODES.include?(mode)
+
+      valid = ReactOnRailsPro::PreSeedRendererCache::VALID_MODES.map(&:to_s).join(", ")
+      raise ReactOnRailsPro::Error,
+            "ASSETS_PRECOMPILE_RENDERER_CACHE_MODE must be one of: #{valid} (got #{raw.inspect})"
     end
+    private_class_method :pre_seed_renderer_cache_mode
 
     def build_or_fetch_bundles
       if disable_precompile_cache?

data/lib/react_on_rails_pro/async_props_emitter.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module ReactOnRailsPro
+  # Emitter class for sending async props incrementally during streaming render.
+  # Used by stream_react_component_with_async_props helper.
+  #
+  # PROTOCOL:
+  # Each call to `emit.call(prop_name, value)` sends an NDJSON line to the Node renderer:
+  #   {"bundleTimestamp": "abc123", "updateChunk": "(function(){...})()"}
+  #
+  # The updateChunk JavaScript accesses the AsyncPropsManager via sharedExecutionContext
+  # and resolves the promise for that prop, allowing React to continue rendering.
+  #
+  # WHY NOT USE GLOBAL VARIABLES?
+  # Global variables in Node.js VM persist across requests, causing data leakage.
+  # sharedExecutionContext is scoped to a single HTTP request (ExecutionContext).
+  #
+  # @example Usage in view
+  #   stream_react_component_with_async_props("Dashboard") do |emit|
+  #     emit.call("users", User.all.to_a)      # Sends immediately
+  #     emit.call("posts", Post.recent.to_a)   # Sends when ready
+  #   end
+  class AsyncPropsEmitter
+    def initialize(bundle_timestamp, request_stream)
+      @bundle_timestamp = bundle_timestamp
+      @request_stream = request_stream
+    end
+
+    # Sends an async prop to the Node renderer.
+    # The prop value is JSON-serialized and sent as an NDJSON line.
+    # On the Node side, this triggers asyncPropsManager.setProp(propName, value).
+    def call(prop_name, prop_value)
+      update_chunk = generate_update_chunk(prop_name, prop_value)
+      @request_stream << "#{update_chunk.to_json}\n"
+    rescue StandardError => e
+      Rails.logger.error do
+        backtrace = e.backtrace&.first(5)&.join("\n")
+        "[ReactOnRailsPro::AsyncProps] Failed to send async prop '#{prop_name}': " \
+          "#{e.class} - #{e.message}\n#{backtrace}"
+      end
+      # Continue - don't abort entire render because one prop failed
+    end
+
+    # Generates the chunk that should be executed when the request stream closes
+    # This tells the asyncPropsManager to end the stream
+    def end_stream_chunk
+      {
+        bundleTimestamp: @bundle_timestamp,
+        updateChunk: generate_end_stream_js
+      }
+    end
+
+    private
+
+    def generate_update_chunk(prop_name, value)
+      {
+        bundleTimestamp: @bundle_timestamp,
+        updateChunk: generate_set_prop_js(prop_name, value)
+      }
+    end
+
+    def generate_set_prop_js(prop_name, value)
+      <<~JS.strip
+        (function(){
+          var asyncPropsManager = ReactOnRails.getOrCreateAsyncPropsManager(sharedExecutionContext);
+          asyncPropsManager.setProp(#{prop_name.to_json}, #{value.to_json});
+        })()
+      JS
+    end
+
+    def generate_end_stream_js
+      <<~JS.strip
+        (function(){
+          var asyncPropsManager = ReactOnRails.getOrCreateAsyncPropsManager(sharedExecutionContext);
+          asyncPropsManager.endStream();
+        })()
+      JS
+    end
+  end
+end

data/lib/react_on_rails_pro/concerns/stream.rb

@@ -62,7 +62,7 @@ module ReactOnRailsPro
         # 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)
+        response.stream.write(template_string.lstrip)
 
         drain_streams_concurrently(parent_task)
         # Do not close the response stream in an ensure block.