react_on_rails_pro 16.4.0 → 16.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 60409cc43b525dfd549f76e44c06415eb08c73922949a48c978b637896c673f4
-  data.tar.gz: 81d82eef38a26b39bf815cdcd441cef9b6f3d90d1fec6b652c2634ac3bd4c581
+  metadata.gz: 555e14ff0b3a9fe0dbdf0d03195d25512f535ce488f426f8258af5dde9e93fa3
+  data.tar.gz: 2aa2508ce583c9b6c3907f990d8a07ce151c122a610524f89ea8a4b5fc75218c
 SHA512:
-  metadata.gz: c22f283f9287aace4be8cada790b66ac5dde64855a5b5c1de610f89bf9d1498db6709f5b8d90829124f9a9a9bcbf328798762603bcb42fb12877261cf2c96aa2
-  data.tar.gz: 2d81b86dabbc427b7902c105982bae739390277fc6904950017a8db3253e65f61d198e194e8ba60eb99479a087cfa62a76bea8eaa38ec73a15e619e55e82e469
+  metadata.gz: 58c950e2ace03c47a86777a398e8260d1ab67a0d28a9838431be74e181c6345af08e8ecf99d8500a179a4c62c9e871af9aa1ceef5991f199452cc2c3cdea0b6a
+  data.tar.gz: 8df15aa0b502450842d744049f7f17aff8843b0afddccf0d97cdb926d0497fdf26cb6e834ca781ec4bd532e9ddf01bc237d14643a088eb8f854d1ea969bb840f

data/CONTRIBUTING.md

@@ -22,9 +22,9 @@ See the example apps under `/spec`
 
 For non-doc fixes:
 
-- Provide changelog entry in the [unreleased section of the CHANGELOG.md](https://github.com/shakacode/react_on_rails/blob/master/react_on_rails_pro/CHANGELOG.md#unreleased).
+- Provide changelog entry in the [unreleased section of the CHANGELOG.md](https://github.com/shakacode/react_on_rails/blob/main/react_on_rails_pro/CHANGELOG.md#unreleased).
 - Ensure CI passes and that you added a test that passes with the fix and fails without the fix.
-- Squash all commits down to one with a nice commit message _ONLY_ once final review is given. Make sure this single commit is rebased on top of master.
+- Squash all commits down to one with a nice commit message _ONLY_ once final review is given. Make sure this single commit is rebased on top of main.
 - Please address all code review comments.
 - Ensure that docs are updated accordingly if a feature is added.
 
@@ -46,7 +46,7 @@ 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 React on Rails docs site](https://reactonrails.com/docs/pro/react-on-rails-pro/) and when browsing the GitHub repo.
+When making doc changes, we want the change to work on both [the React on Rails docs site](https://reactonrails.com/docs/pro) and when browsing the GitHub repo.
 For links from docs pages to non-doc files, use full GitHub URLs so links resolve correctly in both contexts.
 
 ### Links to other docs:
@@ -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/master/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/tree/main/react_on_rails_pro/spec/dummy/config/initializers/react_on_rails.rb)`
 
 ## To run tests:
 
@@ -70,7 +70,7 @@ React on Rails Pro shares the optimized CI pipeline with the main gem. The CI sy
 ### CI Behavior
 
 - **On PRs/Branches**: Runs reduced test matrix (latest Ruby/Node versions only) for faster feedback
-- **On Master**: Runs full test matrix (all Ruby/Node/dependency combinations) for complete coverage
+- **On Main**: Runs full test matrix (all Ruby/Node/dependency combinations) for complete coverage
 - **Docs-only changes**: CI skips entirely when only `.md` files or `docs/` directory change
 
 ### Local CI Tools
@@ -88,7 +88,7 @@ cd ..
 # Auto-detect what to test (includes Pro tests if Pro files changed)
 bin/ci-local
 
-# Run all CI checks (same as master branch)
+# Run all CI checks (same as main branch)
 bin/ci-local --all
 
 # Quick check - only fast tests
@@ -103,7 +103,7 @@ Analyzes changes to both main gem and Pro:
 
 ```bash
 # From repository root
-script/ci-changes-detector origin/master
+script/ci-changes-detector origin/main
 ```
 
 ### CI Best Practices for Pro

data/Gemfile.development_dependencies

@@ -20,7 +20,7 @@ gem "pg"
 
 # Turbolinks makes following links in your web application faster. Read more: https://github.com/rails/turbolinks
 gem "turbolinks"
-gem "sqlite3", "~> 1.4"
+gem "sqlite3", "~> 2.0"
 gem "jquery-rails"
 gem "sprockets"
 gem "sass-rails"

data/Gemfile.lock

@@ -9,7 +9,7 @@ GIT
 PATH
   remote: ..
   specs:
-    react_on_rails (16.4.0)
+    react_on_rails (16.5.1)
       addressable
       connection_pool
       execjs (~> 2.5)
@@ -20,16 +20,16 @@ PATH
 PATH
   remote: .
   specs:
-    react_on_rails_pro (16.4.0)
+    react_on_rails_pro (16.5.1)
       addressable
-      async (>= 2.6)
+      async (>= 2.29)
       connection_pool
       execjs (~> 2.9)
       http-2 (>= 1.1.1)
       httpx (~> 1.5)
       jwt (~> 2.7)
       rainbow
-      react_on_rails (= 16.4.0)
+      react_on_rails (= 16.5.1)
 
 GEM
   remote: https://rubygems.org/
@@ -440,9 +440,9 @@ GEM
       actionpack (>= 6.1)
       activesupport (>= 6.1)
       sprockets (>= 3.0.0)
-    sqlite3 (1.7.3-arm64-darwin)
-    sqlite3 (1.7.3-x86_64-darwin)
-    sqlite3 (1.7.3-x86_64-linux)
+    sqlite3 (2.9.2-arm64-darwin)
+    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)
@@ -538,7 +538,7 @@ DEPENDENCIES
   spring
   spring-watcher-listen
   sprockets
-  sqlite3 (~> 1.4)
+  sqlite3 (~> 2.0)
   turbolinks
   web-console
   webdrivers (= 5.3.0)

data/LICENSE_SETUP.md

@@ -217,7 +217,7 @@ jobs:
               `**Status:** ${status}`,
               `**Days remaining:** ${days}`,
               '',
-              'Renew at https://www.shakacode.com/react-on-rails-pro/',
+              'Renew at https://pro.reactonrails.com/',
               'or contact support@shakacode.com',
             ].join('\n');
 

data/README.md

@@ -267,9 +267,11 @@ end
 
 | React on Rails Pro | React on Rails | Rails  | Ruby   | React   |
 | ------------------ | -------------- | ------ | ------ | ------- |
-| 4.x                | >= 16.0        | >= 7.0 | >= 3.2 | >= 18   |
+| 16.x               | >= 16.0        | >= 7.0 | >= 3.2 | >= 18   |
 | 3.x                | >= 13.0        | >= 6.0 | >= 3.0 | >= 16.8 |
 
+> **Note:** Pro version numbers were aligned with the core gem starting at 16.2.0. Pro 16.x is the direct successor to Pro 3.x/4.x.
+
 **📖 Check compatibility**: See [CHANGELOG.md](./CHANGELOG.md) for version-specific requirements
 
 ---
@@ -286,15 +288,7 @@ Since React on Rails Pro is part of the public monorepo, you can install it dire
 
 ```ruby
 # Gemfile
-gem 'react_on_rails_pro', '~> 4.0'
-```
-
-Or use a specific version/tag:
-
-```ruby
-gem 'react_on_rails_pro', git: 'https://github.com/shakacode/react_on_rails.git',
-                          glob: 'react_on_rails_pro/*.gemspec',
-                          tag: 'v4.0.0'
+gem 'react_on_rails_pro', '~> 16.0'
 ```
 
 Then run:

data/app/helpers/react_on_rails_pro_helper.rb

@@ -5,6 +5,7 @@
 # 2. Keep all #{some_var} fully to the left so that all indentation is done evenly in that var
 
 require "react_on_rails/helper"
+require "async/promise"
 
 # rubocop:disable Metrics/ModuleLength
 module ReactOnRailsProHelper
@@ -183,7 +184,7 @@ module ReactOnRailsProHelper
   # `rsc_payload_route` helper function. The returned data from this function is used internally by
   # components registered using the `registerServerComponent` function. Don't use it unless you need
   # more control over the RSC payload generation. To know more about RSC payload, see the following link:
-  # @see https://www.shakacode.com/react-on-rails-pro/docs/how-react-server-components-works.md
+  # @see https://reactonrails.com/docs/pro/react-server-components/how-react-server-components-work
   #   for technical details about the RSC payload format
   def rsc_payload_react_component(component_name, options = {})
     # rsc_payload_react_component doesn't have the prerender option
@@ -428,71 +429,63 @@ module ReactOnRailsProHelper
   end
 
   def consumer_stream_async(on_complete:)
-    require "async/variable"
-
     if @async_barrier.nil?
       raise ReactOnRails::Error,
             "You must call stream_view_containing_react_components to render the view containing the react component"
     end
 
-    # Create a variable to hold the first chunk for synchronous return
-    first_chunk_var = Async::Variable.new
+    # Create a promise to hold the first chunk for synchronous return.
+    # Async::Promise replaces Async::Variable (deprecated in async v2.29.0).
+    first_chunk_promise = Async::Promise.new
     all_chunks = [] if on_complete # Only collect if callback provided
 
     # Start an async task on the barrier to stream all chunks
     @async_barrier.async do
       stream = yield
-      fully_consumed = process_stream_chunks(stream, first_chunk_var, all_chunks)
+      fully_consumed = process_stream_chunks(stream, first_chunk_promise, 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
-      # (first chunk was returned successfully), the assignment raises and we
-      # fall through to re-raise so barrier.wait propagates the error later.
-      begin
-        first_chunk_var.value = e
-        # Variable accepted the error — this is a pre-first-chunk failure (e.g., shell error).
-        # The caller will detect the Exception value and raise it synchronously,
-        # BEFORE the response is committed, enabling a proper HTTP redirect.
-        # Do NOT re-raise here: the caller owns the error now.
-      rescue StandardError
-        # Variable was already resolved — the first chunk was returned successfully.
-        # This is a post-first-chunk error. Re-raise so barrier.wait propagates it
-        # (the response is already committed at that point, so only JS redirect is possible).
-        raise e
-      end
+      # Propagate the error to the calling fiber via the promise.
+      # A promise can only be resolved/rejected once — check before acting.
+      # resolved? returns true for both fulfilled and rejected states ("settled").
+      # Safe without a lock: only this task can reject here, and Async uses
+      # cooperative scheduling so no fiber switch can occur between resolved?
+      # and reject/raise below.
+      # If already settled, the first chunk was returned successfully.
+      # This is a post-first-chunk error. Re-raise so barrier.wait propagates it
+      # (the response is already committed at that point, so only JS redirect is possible).
+      raise if first_chunk_promise.resolved?
+
+      # Promise not yet resolved — this is a pre-first-chunk failure (e.g., shell error).
+      # Reject the promise so .wait auto-raises in the caller,
+      # BEFORE the response is committed, enabling a proper HTTP redirect.
+      # Do NOT re-raise here: the caller owns the error now.
+      first_chunk_promise.reject(e)
     end
 
     # 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
-    # stream_view_containing_react_components, so the response is NOT yet committed
-    # and rescue_from can perform a proper HTTP redirect.
-    raise result if result.is_a?(StandardError)
-
-    result
+    # Async::Promise#wait blocks until resolved, then returns the stored value.
+    # If the promise was rejected, .wait automatically re-raises the exception.
+    first_chunk_promise.wait
   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)
+  def process_stream_chunks(stream, first_chunk_promise, all_chunks)
     is_first = true
 
     stream.each_chunk do |chunk|
       # Client disconnected — abort without caching partial results
       if response.stream.closed?
-        first_chunk_var.value = nil if is_first
+        first_chunk_promise.resolve(nil) if is_first
         return false
       end
 
       all_chunks&.push(chunk)
 
       if is_first
-        # Store first chunk in variable for synchronous return
-        first_chunk_var.value = chunk
+        # Store first chunk in promise for synchronous return
+        first_chunk_promise.resolve(chunk)
         is_first = false
       else
         # Enqueue remaining chunks to main output queue
@@ -501,7 +494,7 @@ module ReactOnRailsProHelper
     end
 
     # Handle case where stream has no chunks
-    first_chunk_var.value = nil if is_first
+    first_chunk_promise.resolve(nil) if is_first
     true
   end
 

data/lib/react_on_rails_pro/compression_middleware_guard.rb

@@ -6,7 +6,7 @@ require "timeout"
 module ReactOnRailsPro
   class CompressionMiddlewareGuard
     COMPATIBILITY_GUIDE_PATH =
-      "https://www.shakacode.com/react-on-rails/docs/building-features/" \
+      "https://reactonrails.com/docs/building-features/" \
       "streaming-server-rendering/#compression-middleware-compatibility"
     PROBLEMATIC_MIDDLEWARES = %w[Rack::Deflater Rack::Brotli].freeze
     PROBE_TIMEOUT_SECONDS = 1

data/lib/react_on_rails_pro/engine.rb

@@ -4,7 +4,7 @@ require "rails/railtie"
 
 module ReactOnRailsPro
   class Engine < Rails::Engine
-    LICENSE_URL = "https://www.shakacode.com/react-on-rails-pro/"
+    LICENSE_URL = "https://pro.reactonrails.com/"
     # 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"
     private_constant :LICENSE_URL

data/lib/react_on_rails_pro/license_task_formatter.rb

@@ -64,9 +64,9 @@ module ReactOnRailsPro
 
       puts ""
       if info[:status] == :expired
-        puts "WARNING: License has expired. Renew at https://www.shakacode.com/react-on-rails-pro/"
+        puts "WARNING: License has expired. Renew at https://pro.reactonrails.com/"
       else
-        puts "WARNING: License expires within 30 days. Renew at https://www.shakacode.com/react-on-rails-pro/"
+        puts "WARNING: License expires within 30 days. Renew at https://pro.reactonrails.com/"
       end
     end
   end

data/lib/react_on_rails_pro/request.rb

@@ -44,7 +44,8 @@ module ReactOnRailsPro
       def upload_assets
         Rails.logger.info { "[ReactOnRailsPro] Uploading assets" }
 
-        # Check if server bundle exists before trying to upload assets
+        # Early checks with descriptive messages. add_bundle_to_form(check_bundle: true) also
+        # validates existence, but these provide clearer context for the rake task user.
         server_bundle_path = ReactOnRails::Utils.server_bundle_js_file_path
         unless File.exist?(server_bundle_path)
           raise ReactOnRailsPro::Error, "Server bundle not found at #{server_bundle_path}. " \
@@ -66,6 +67,12 @@ module ReactOnRailsPro
         end
 
         form = form_with_assets_and_bundle
+        # TODO: targetBundles is only kept for backward compatibility with older node renderers
+        # (protocol 2.0.0) that require it. The new node renderer derives target directories from
+        # the bundle_<hash> form keys and ignores this field. Remove at the next breaking version.
+        # Note: it's not mandatory to keep this until then — users are expected to upgrade the
+        # node renderer and react_on_rails gem to the same version together — but it's an easy
+        # backward compatibility safeguard.
         form["targetBundles"] = target_bundles
 
         perform_request("/upload-assets", form: form)

data/lib/react_on_rails_pro/version.rb

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

data/lib/tasks/assets.rake

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require "active_support"
+
+namespace :react_on_rails_pro do
+  desc "Copy assets to local node-renderer"
+  task pre_stage_bundle_for_node_renderer: :environment do
+    ReactOnRailsPro::PrepareNodeRenderBundles.call
+  end
+
+  desc "Copy assets to remote node-renderer"
+  task copy_assets_to_remote_vm_renderer: :environment do
+    puts "[ReactOnRailsPro] Copying assets to remote node-renderer #{ReactOnRailsPro.configuration.renderer_url}"
+    ReactOnRailsPro::Request.upload_assets
+  end
+end

data/lib/tasks/license.rake

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require "react_on_rails_pro/license_task_formatter"
+
+namespace :react_on_rails_pro do
+  desc "Verify the React on Rails Pro license and display its status"
+  task verify_license: :environment do
+    format = ENV.fetch("FORMAT", "text")
+    info = ReactOnRailsPro::LicenseValidator.license_info
+    result = ReactOnRailsPro::LicenseTaskFormatter.build_result(info)
+
+    if format.casecmp("json").zero?
+      require "json"
+      puts JSON.pretty_generate(result)
+    else
+      ReactOnRailsPro::LicenseTaskFormatter.print_text(result, info)
+    end
+
+    raise "License verification failed: #{info[:status]}" if info[:status] != :valid
+  end
+end

data/lib/tasks/v8_log_processor.rake

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require "react_on_rails_pro/v8_log_processor"
+
+namespace :react_on_rails_pro do
+  desc <<-DESC
+    Processes V8 log files by moving them to a specified directory, generating a combined
+    V8 profile, and optionally deleting the original log files. The resulting profile.v8log.json file
+    can be analyzed using tools like Speed Scope (https://www.speedscope.app) or Chrome Developer Tools
+    to visualize and analyze performance metrics.
+
+    @param keep_files [String] 'true' to keep the original log files, 'false' to delete them.
+    @param output_dir [String] The directory where log files are moved and the profile is saved.
+  DESC
+  task :process_v8_logs, %i[keep_files output_dir] => [:environment] do |_, args|
+    args.with_defaults(keep_files: "false", output_dir: "v8_profiles")
+    keep_files = args.keep_files == "true"
+    ReactOnRailsPro::V8LogProcessor.process_v8_logs(keep_files, args.output_dir)
+  end
+end

data/react_on_rails_pro.gemspec

@@ -22,7 +22,7 @@ Gem::Specification.new do |s|
 
   s.files = Dir.chdir(__dir__) do
     `git ls-files -z`.split("\x0").reject do |f|
-      f.match(%r{^(test|spec|features|tmp|node_modules|packages|coverage|Gemfile.lock|lib/tasks)/})
+      f.match(%r{^(test|spec|features|tmp|node_modules|packages|coverage|Gemfile.lock)/})
     end
   end
   s.bindir        = "exe"
@@ -39,7 +39,7 @@ Gem::Specification.new do |s|
   #   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.6"
+  s.add_runtime_dependency "async", ">= 2.29"
   s.add_runtime_dependency "rainbow"
   s.add_runtime_dependency "react_on_rails", ReactOnRails::VERSION
   s.add_development_dependency "bundler"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: react_on_rails_pro
 version: !ruby/object:Gem::Version
-  version: 16.4.0
+  version: 16.5.1
 platform: ruby
 authors:
 - Justin Gordon
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-03-17 00:00:00.000000000 Z
+date: 2026-03-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -100,14 +100,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '2.6'
+        version: '2.29'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '2.6'
+        version: '2.29'
 - !ruby/object:Gem::Dependency
   name: rainbow
   requirement: !ruby/object:Gem::Requirement
@@ -128,14 +128,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 16.4.0
+        version: 16.5.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 16.4.0
+        version: 16.5.1
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -254,6 +254,9 @@ files:
 - lib/react_on_rails_pro/utils.rb
 - lib/react_on_rails_pro/v8_log_processor.rb
 - lib/react_on_rails_pro/version.rb
+- lib/tasks/assets.rake
+- lib/tasks/license.rake
+- lib/tasks/v8_log_processor.rake
 - package-scripts.yml
 - package.json
 - rakelib/dummy_apps.rake