inertia_rails 3.13.0 → 3.15.0

data/lib/inertia_rails/renderer.rb

@@ -48,7 +48,7 @@ module InertiaRails
                                   else
                                     "#{@response.headers['Vary']}, X-Inertia"
                                   end
-      if @request.headers['X-Inertia']
+      if @request.inertia?
         @response.set_header('X-Inertia', 'true')
         @render_method.call json: page.to_json, status: @response.status, content_type: Mime[:json]
       else
@@ -97,15 +97,17 @@ module InertiaRails
     def computed_props
       # rubocop:disable Style/MultilineBlockChain
       @props
-        .tap do |merged_props| # Always keep errors in the props
-          if merged_props.key?(:errors) && !merged_props[:errors].is_a?(BaseProp)
-            errors = merged_props[:errors]
-            merged_props[:errors] = InertiaRails.always { errors }
-          end
+        .tap do |merged_props|
+        # Always keep errors in the props
+        if merged_props.key?(:errors) && !merged_props[:errors].is_a?(BaseProp)
+          errors = merged_props[:errors]
+          merged_props[:errors] = InertiaRails.always { errors }
         end
+      end
         .then { |props| deep_transform_props(props) } # Internal hydration/filtering
         .then { |props| @configuration.prop_transformer(props: props) } # Apply user-defined prop transformer
-        .tap do |props| # Add meta tags last (never transformed)
+        .tap do |props|
+        # Add meta tags last (never transformed)
         props[:_inertia_meta] = meta_tags if meta_tags.present?
       end
       # rubocop:enable Style/MultilineBlockChain
@@ -128,6 +130,9 @@ module InertiaRails
       @page[:scrollProps] = scroll_props if scroll_props.present?
       @page.merge!(resolve_merge_props)
 
+      once_props = resolve_once_props
+      @page[:onceProps] = once_props if once_props.present?
+
       @page
     end
 
@@ -173,6 +178,17 @@ module InertiaRails
       }.delete_if { |_, v| v.blank? }
     end
 
+    def resolve_once_props
+      @props.each_with_object({}) do |(key, prop), result|
+        next unless prop.try(:once?)
+        next if excluded_by_partial_request?([key.to_s])
+
+        once_key = (prop.once_key || key).to_s
+
+        result[once_key] = { prop: key.to_s, expiresAt: prop.expires_at }.compact
+      end
+    end
+
     def resolve_match_on_props
       all_merge_props.filter_map do |key, prop|
         prop.match_on.map! { |ms| "#{key}.#{ms}" } if prop.match_on.present?
@@ -251,6 +267,10 @@ module InertiaRails
       @partial_except_keys ||= (@request.headers['X-Inertia-Partial-Except'] || '').split(',').compact_blank!
     end
 
+    def except_once_keys
+      @except_once_keys ||= (@request.headers['X-Inertia-Except-Once-Props'] || '').split(',').compact_blank!
+    end
+
     def rendering_partial_component?
       @request.headers['X-Inertia-Partial-Component'] == @component
     end
@@ -265,12 +285,8 @@ module InertiaRails
 
     def keep_prop?(prop, path)
       return true if prop.is_a?(AlwaysProp)
-
-      if rendering_partial_component? && (partial_keys.present? || partial_except_keys.present?)
-        path_with_prefixes = path_prefixes(path)
-        return false if excluded_by_only_partial_keys?(path_with_prefixes)
-        return false if excluded_by_except_partial_keys?(path_with_prefixes)
-      end
+      return false if excluded_by_once_cache?(prop, path)
+      return false if excluded_by_partial_request?(path)
 
       # Precedence: Evaluate IgnoreOnFirstLoadProp only after partial keys have been checked
       return false if prop.is_a?(IgnoreOnFirstLoadProp) && !rendering_partial_component?
@@ -278,6 +294,29 @@ module InertiaRails
       true
     end
 
+    def excluded_by_once_cache?(prop, path)
+      return false unless prop.try(:once?)
+      return false if prop.try(:fresh?)
+      return false if explicitly_requested?(path)
+
+      once_key = (prop.once_key || path.join('.')).to_s
+      except_once_keys.include?(once_key)
+    end
+
+    def explicitly_requested?(path)
+      return false unless rendering_partial_component? && partial_keys.present?
+
+      path_with_prefixes = path_prefixes(path)
+      (path_with_prefixes & partial_keys).any?
+    end
+
+    def excluded_by_partial_request?(path)
+      return false unless rendering_partial_component? && (partial_keys.present? || partial_except_keys.present?)
+
+      path_with_prefixes = path_prefixes(path)
+      excluded_by_only_partial_keys?(path_with_prefixes) || excluded_by_except_partial_keys?(path_with_prefixes)
+    end
+
     def path_prefixes(parts)
       (0...parts.length).map do |i|
         parts[0..i].join('.')

data/lib/inertia_rails/version.rb

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

data/lib/inertia_rails.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'inertia_rails/version'
 require 'inertia_rails/renderer'
 require 'inertia_rails/engine'
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: inertia_rails
 version: !ruby/object:Gem::Version
-  version: 3.13.0
+  version: 3.15.0
 platform: ruby
 authors:
 - Brian Knoles
@@ -9,7 +9,7 @@ authors:
 - Eugene Granovsky
 bindir: bin
 cert_chain: []
-date: 2025-11-19 00:00:00.000000000 Z
+date: 2025-12-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -47,6 +47,7 @@ files:
 - lib/generators/inertia/install/install_generator.rb
 - lib/generators/inertia/install/js_package_manager.rb
 - lib/generators/inertia/install/templates/assets/inertia.svg
+- lib/generators/inertia/install/templates/assets/rails.svg
 - lib/generators/inertia/install/templates/assets/react.svg
 - lib/generators/inertia/install/templates/assets/svelte.svg
 - lib/generators/inertia/install/templates/assets/vite_ruby.svg
@@ -199,8 +200,10 @@ files:
 - lib/inertia_rails/meta_tag.rb
 - lib/inertia_rails/meta_tag_builder.rb
 - lib/inertia_rails/middleware.rb
+- lib/inertia_rails/once_prop.rb
 - lib/inertia_rails/optional_prop.rb
 - lib/inertia_rails/prop_mergeable.rb
+- lib/inertia_rails/prop_onceable.rb
 - lib/inertia_rails/renderer.rb
 - lib/inertia_rails/rspec.rb
 - lib/inertia_rails/scroll_metadata.rb