inertia_rails 3.19.0 → 3.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 91497e407b470afd9fdc6c938bf97fd1f7e74e8b39ab6e76ca8b8c50b2d92f75
-  data.tar.gz: d132dd3a36f682357bcbeb63e7d0e825449603b2928d760c5a725e9a35657fc3
+  metadata.gz: e56b13d7d02abe1f35709de08b6873cc0d407215a97891502bb4ee7439e0d005
+  data.tar.gz: a627501dd94ab5d9ad747c2decce31ab47fe4870e677d2197395680cb4dfaa3e
 SHA512:
-  metadata.gz: 385280b11bf6fc2aae7f067bb5c77e1bc641d886aa71aff1e3f25ded9db24256a53b68b0daeb4722fe28bca45f0e7b5daeff308b81d326348f3852b8e54e7f2e
-  data.tar.gz: 21548a2a8b4e1bf1ecf307d2298c78e24a7fad344f881197d8f421538ca7769704a2301979f45990c3af46fdf1578b49c53a65cfcd169ba5ac6b63150bccce1e
+  metadata.gz: 5f9b35e5039a9516daaa7ff6d9c1b702011d3ddd2161fb40922143fde7951522ca3e8268691d2b3490baae217febb046b04d07d677facf39b81dad9f1f5bd076
+  data.tar.gz: 3523dadfe1c2877767cf534b4a6c95ef979250bbf3c78a86af31e6220247cb860d020402b359a32c8b5295b1d246aa30d8a5a590dd8fae44de89623b24521880

data/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.20.0] - 2026-04-04
+
+* Fix partial reload filtering with arrays
+* Docs update for the v3.0 upgrade
+* Add plugin for Puma so that SSR Just Works in production for apps using Puma
+
 ## [3.19.0] - 2026-03-25
 
 * Upgrades to support Inertia.js 3.x! All thanks to @skyrukov!

data/lib/inertia_rails/configuration.rb

@@ -2,6 +2,8 @@
 
 module InertiaRails
   class Configuration
+    DEFAULT_SSR_URL = 'http://localhost:13714'
+
     DEFAULTS = {
       # Whether to combine hashes with the same keys instead of replacing them.
       deep_merge_shared_data: false,
@@ -24,6 +26,7 @@ module InertiaRails
 
       # SSR options.
       ssr_enabled: false,
+      # URL of the SSR server. When nil, defaults to DEFAULT_SSR_URL.
       ssr_url: nil,
       ssr_raise_on_error: false,
       on_ssr_error: nil,
@@ -35,6 +38,9 @@ module InertiaRails
       # Accepts true, false/nil, or a Hash of Rails.cache.fetch options.
       # Lambdas are supported (instance_exec'd in controller context).
       ssr_cache: nil,
+      # JavaScript runtime used to run the SSR bundle (e.g. "node", "bun", "deno").
+      # When nil, auto-detects from lockfiles or falls back to "node".
+      ssr_runtime: nil,
 
       # Used to detect version drift between server and client.
       version: nil,

data/lib/inertia_rails/props_resolver.rb

@@ -88,6 +88,8 @@ module InertiaRails
         end
 
         if prop.is_a?(Array)
+          next if !parent_was_resolved && excluded_by_partial_request?(path)
+
           transformed_props[key] = transform_array(prop, path, parent_was_resolved: parent_was_resolved)
           next
         end

data/lib/inertia_rails/ssr.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module InertiaRails
+  module SSR
+    class << self
+      def vite_dev_server_url
+        # vite_rails: TCP probe
+        if defined?(ViteRuby) && ViteRuby.instance.dev_server_running?
+          config = ViteRuby.config
+          return "#{config.protocol}://#{config.host_with_port}"
+        end
+
+        # rails_vite + jsbundling: file-based
+        path = Rails.root.join('tmp/rails-vite.json')
+        JSON.parse(path.read)['url'] if path.exist?
+      rescue StandardError
+        nil
+      end
+
+      def vite_dev_server_running?
+        !vite_dev_server_url.nil?
+      end
+    end
+  end
+end

data/lib/inertia_rails/ssr_renderer.rb

@@ -29,7 +29,10 @@ module InertiaRails
     end
 
     def request
-      response = Net::HTTP.post(URI(url), page_json, 'Content-Type' => 'application/json')
+      uri = URI.parse(url)
+      response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
+        http.post(uri.request_uri, page_json, 'Content-Type' => 'application/json')
+      end
 
       unless response.is_a?(Net::HTTPSuccess)
         body = begin
@@ -74,14 +77,14 @@ module InertiaRails
       elsif (dev_url = vite_dev_server_url)
         "#{dev_url}/__inertia_ssr"
       else
-        'http://localhost:13714/render'
+        "#{InertiaRails::Configuration::DEFAULT_SSR_URL}/render"
       end
     end
 
     def vite_dev_server_url
       return @vite_dev_server_url if defined?(@vite_dev_server_url)
 
-      @vite_dev_server_url = detect_vite_dev_url
+      @vite_dev_server_url = InertiaRails::SSR.vite_dev_server_url
     end
 
     def bundle_exists?
@@ -92,19 +95,5 @@ module InertiaRails
 
       Array(bundle).any? { |path| File.exist?(path) }
     end
-
-    def detect_vite_dev_url
-      # vite_rails: TCP probe, no metadata file
-      if defined?(ViteRuby) && ViteRuby.instance.dev_server_running?
-        config = ViteRuby.config
-        return "#{config.protocol}://#{config.host_with_port}"
-      end
-
-      # rails_vite + jsbundling: file-based
-      path = Rails.root.join('tmp/rails-vite.json')
-      JSON.parse(path.read)['url'] if path.exist?
-    rescue JSON::ParserError
-      nil
-    end
   end
 end

data/lib/inertia_rails/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module InertiaRails
-  VERSION = '3.19.0'
+  VERSION = '3.20.0'
 end

data/lib/inertia_rails.rb

@@ -27,6 +27,9 @@ require_relative 'inertia_rails/scroll_prop'
 require_relative 'inertia_rails/prop_evaluator'
 require_relative 'inertia_rails/props_resolver'
 
+# ssr
+require_relative 'inertia_rails/ssr'
+
 # rendering
 require_relative 'inertia_rails/meta_tag'
 require_relative 'inertia_rails/meta_tag_builder'

data/lib/puma/plugin/inertia_ssr.rb

@@ -0,0 +1,167 @@
+# frozen_string_literal: true
+
+require 'net/http'
+
+Puma::Plugin.create do
+  BOOT_TIMEOUT = 30 # rubocop:disable Lint/ConstantDefinitionInBlock
+
+  def start(launcher)
+    @log_writer = launcher.log_writer
+    @running = true
+    @boot_signal = Queue.new
+
+    in_background do
+      @boot_signal.pop
+      run_ssr_loop
+    end
+
+    events = launcher.events
+
+    if events.respond_to?(:after_booted)
+      events.after_booted { @boot_signal.push(true) }
+      events.after_stopped { stop_ssr }
+      events.before_restart { stop_ssr }
+    else
+      events.on_booted { @boot_signal.push(true) }
+      events.on_stopped { stop_ssr }
+      events.on_restart { stop_ssr }
+    end
+  end
+
+  private
+
+  def run_ssr_loop
+    return unless ssr_enabled?
+    return if vite_dev_server_running?
+
+    bundle = resolve_bundle
+    return unless bundle
+
+    runtime = resolve_runtime
+    uri = URI(resolve_base_url)
+    consecutive_crashes = 0
+    delay = 1
+
+    while @running
+      break if vite_dev_server_running?
+
+      begin
+        @pid = spawn(runtime, bundle)
+      rescue Errno::ENOENT
+        log "! Inertia SSR: '#{runtime}' not found in PATH"
+        break
+      end
+
+      if wait_for_server(uri)
+        log "* Inertia SSR: server ready (pid: #{@pid})"
+        consecutive_crashes = 0
+        delay = 1
+      else
+        log "! Inertia SSR: server failed to respond within #{BOOT_TIMEOUT}s"
+      end
+
+      _, status = Process.wait2(@pid)
+      break unless @running
+
+      consecutive_crashes += 1
+      if consecutive_crashes >= 10
+        log '! Inertia SSR: too many crashes, giving up'
+        break
+      end
+
+      log "! Inertia SSR: process exited (status: #{status.exitstatus}), restarting in #{delay}s..."
+      sleep delay
+      delay = [delay * 2, 16].min
+    end
+  end
+
+  def stop_ssr
+    @running = false
+    return unless @pid
+
+    Process.waitpid(@pid, Process::WNOHANG)
+
+    # /shutdown correctly handles cluster mode
+    begin
+      uri = URI(resolve_base_url)
+      Net::HTTP.start(uri.host, uri.port, open_timeout: 2, read_timeout: 5) do |http|
+        http.post('/shutdown', '')
+      end
+      Process.wait(@pid)
+    rescue StandardError
+      Process.kill('TERM', @pid)
+      Process.wait(@pid)
+    end
+  rescue Errno::ESRCH, Errno::ECHILD
+    # already exited
+  ensure
+    @pid = nil
+  end
+
+  def wait_for_server(uri) # rubocop:disable Naming/PredicateMethod
+    BOOT_TIMEOUT.times do
+      return false unless @running
+
+      begin
+        Net::HTTP.start(uri.host, uri.port, open_timeout: 1, read_timeout: 1) do |http|
+          http.get('/health')
+        end
+        return true
+      rescue Errno::ECONNREFUSED, Errno::EADDRNOTAVAIL, Net::OpenTimeout, Net::ReadTimeout
+        sleep 1
+      end
+    end
+    false
+  end
+
+  def ssr_enabled?
+    InertiaRails.configuration.ssr_enabled
+  end
+
+  def resolve_runtime
+    InertiaRails.configuration.ssr_runtime || detect_runtime
+  end
+
+  def detect_runtime
+    root = defined?(Rails) ? Rails.root : Pathname.new(Dir.pwd)
+    if File.exist?(root.join('bun.lockb')) || File.exist?(root.join('bun.lock'))
+      'bun'
+    elsif File.exist?(root.join('deno.lock'))
+      'deno'
+    else
+      'node'
+    end
+  end
+
+  def resolve_bundle
+    config = InertiaRails.configuration
+
+    return Array(config.ssr_bundle).find { |path| File.exist?(path) } if config.ssr_bundle
+
+    if defined?(ViteRuby)
+      ssr_dir = ViteRuby.config.ssr_output_dir
+      candidates = Dir.glob(File.join(ssr_dir, 'inertia.*')) if ssr_dir
+      return candidates.first if candidates&.any?
+    end
+
+    path = 'public/assets-ssr/inertia.js'
+    path if File.exist?(path)
+  end
+
+  def resolve_base_url
+    url = InertiaRails.configuration.ssr_url
+    if url
+      url.sub(%r{/(render|__inertia_ssr)\z}, '')
+    else
+      InertiaRails::Configuration::DEFAULT_SSR_URL
+    end
+  end
+
+  def vite_dev_server_running?
+    InertiaRails::SSR.vite_dev_server_running?
+  end
+
+  def log(message)
+    @log_writer.log(message)
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: inertia_rails
 version: !ruby/object:Gem::Version
-  version: 3.19.0
+  version: 3.20.0
 platform: ruby
 authors:
 - Brian Knoles
@@ -9,7 +9,7 @@ authors:
 - Eugene Granovsky
 bindir: bin
 cert_chain: []
-date: 2026-03-25 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -218,9 +218,11 @@ files:
 - lib/inertia_rails/rspec/deprecated.rb
 - lib/inertia_rails/scroll_metadata.rb
 - lib/inertia_rails/scroll_prop.rb
+- lib/inertia_rails/ssr.rb
 - lib/inertia_rails/ssr_renderer.rb
 - lib/inertia_rails/testing.rb
 - lib/inertia_rails/version.rb
+- lib/puma/plugin/inertia_ssr.rb
 - lib/tasks/inertia_rails.rake
 homepage: https://github.com/inertiajs/inertia-rails
 licenses:
@@ -246,7 +248,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Inertia.js adapter for Rails
 test_files: []