alba-inertia 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 36892b105c78f91a4874dca3d397e42be762acf30fcd56f379e1f2672683def0
-  data.tar.gz: 8dfc87dca73d0594fcc7233e48bdf73d2cc62f6f082bfe0e820685cfa827603c
+  metadata.gz: cfe281c753944eadf0114123a314af226fb73fadeac1053a89c11c87577cdc6c
+  data.tar.gz: ad63713f57f9066ec4f0de804d51cd6ea856eec0d09e3e17a443f5327b0a128c
 SHA512:
-  metadata.gz: 74b25910459121487726f3a3d1be5c235dacd494cc25d9bc0dfb337e0900e962be3c5283e8a2667476cf1dcff1314a984781c04ab037f7eddcf2b09379296b48
-  data.tar.gz: d36a4bde371ad4322c595f251ce7a83c4cd0e83e6459695603044d8987e6d029b6556783337135a668ac76410cec19a57634492e805c252c86744d6d95efeddd
+  metadata.gz: 207186eb671f60205cd46f03862d84e6569473b18a7424f19c1eaae61435408fd5aeaf167e7642e9f0d46d3749af6f4ebef92e5d08ca394029e069f3de4f3e98
+  data.tar.gz: 6f6b0825a3bfbe83b1d4cd6c42ae2b2e2d9d789d5c84dfd79d36b480b1d9b9c879feed73b531a40789022f1439e163e6fc62ffdec34c1c1285a6675229b091fb

data/CHANGELOG.md

@@ -7,11 +7,29 @@ and this project adheres to [Semantic Versioning].
 
 ## [Unreleased]
 
+## [0.1.4] - 2026-04-21
+
+### Added
+
+- Support for `InertiaRails.cache` props. ([@skryukov])
+- Support for deferred scroll props. ([@nickpellant])
+- Respect configured `transform_keys` on top-level prop keys. ([@bknoles])
+
+### Changed
+
+- Compatibility with InertiaRails 3.19.0+ load path. ([@bknoles])
+
+## [0.1.3] - 2025-12-08
+
+### Added
+
+- Support for `InertiaRails.once`. ([@skryukov])
+
 ## [0.1.2] - 2025-12-08
 
 ### Added
 
-- Support for `InertiaRails.scroll` attributes. ([@skryukov])
+- Support for `InertiaRails.scroll`. ([@skryukov])
 - Add `serializer_params` option to `render_inertia` and `inertia_serializer_params` controller method for passing params to serializers. ([@skryukov])
 
 ## [0.1.1] - 2025-11-05
@@ -31,9 +49,13 @@ and this project adheres to [Semantic Versioning].
 
 - Initial release ([@skryukov])
 
+[@bknoles]: https://github.com/bknoles
+[@nickpellant]: https://github.com/nickpellant
 [@skryukov]: https://github.com/skryukov
 
-[Unreleased]: https://github.com/skryukov/alba-inertia/compare/v0.1.2...HEAD
+[Unreleased]: https://github.com/skryukov/alba-inertia/compare/v0.1.4...HEAD
+[0.1.4]: https://github.com/skryukov/alba-inertia/compare/v0.1.3...v0.1.4
+[0.1.3]: https://github.com/skryukov/alba-inertia/compare/v0.1.2...v0.1.3
 [0.1.2]: https://github.com/skryukov/alba-inertia/compare/v0.1.1...v0.1.2
 [0.1.1]: https://github.com/skryukov/alba-inertia/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/skryukov/alba-inertia/commits/v0.1.0

data/README.md

@@ -1,5 +1,7 @@
 # Alba::Inertia
 
+[![Gem Version](https://badge.fury.io/rb/alba-inertia.svg)](https://rubygems.org/gems/alba-inertia)
+
 Seamless integration between [Alba](https://github.com/okuramasafumi/alba) serializers and [Inertia Rails](https://inertia-rails.dev/).
 
 ## Features
@@ -8,6 +10,10 @@ Seamless integration between [Alba](https://github.com/okuramasafumi/alba) seria
 - Lazy evaluation for efficient data loading on partial reloads
 - Auto-detection of resource classes based on controller/action naming
 
+<a href="https://evilmartians.com/?utm_source=alba-inertia&utm_campaign=project_page">
+<img src="https://evilmartians.com/badges/sponsored-by-evil-martians.svg" alt="Built by Evil Martians" width="236" height="54">
+</a>
+
 ## Installation
 
 Add to your Gemfile:
@@ -71,8 +77,12 @@ class CoursesIndexResource < ApplicationResource
 
   # Scroll prop with explicit metadata
   has_many :items, inertia: { scroll: :meta }
-  has_many :items, inertia: { scroll: -> { |obj| obj.meta } }
-  has_many :items, inertia: { scroll: -> { |obj| obj.meta }, wrapper: 'data' }
+  has_many :items, inertia: { scroll: ->(obj) { obj.meta } }
+  has_many :items, inertia: { scroll: ->(obj) { obj.meta }, wrapper: 'data' }
+
+  # Once prop
+  has_many :plans, inertia: :once
+  has_many :plans, inertia: { once: { key: 'active_plans', expires_in: 1.hour, fresh: ->(obj) { obj.fresh? } } }
 end
 ```
 

data/lib/alba/inertia/prop_builder.rb

@@ -3,18 +3,24 @@
 module Alba
   module Inertia
     class PropBuilder
+      ONCE_KEYS = %i[once key expires_in fresh]
+
       class << self
         def build(evaluation_block, options, object = nil)
           if options[:optional]
             wrap_optional(evaluation_block, options[:optional], object)
+          elsif options[:once]
+            wrap_once(evaluation_block, options[:once], object)
+          elsif options[:scroll]
+            wrap_scroll(evaluation_block, options[:scroll], object, options)
           elsif options[:defer]
             wrap_defer(evaluation_block, options[:defer], object)
           elsif options[:merge]
             wrap_merge(evaluation_block, options[:merge], object)
-          elsif options[:scroll]
-            wrap_scroll(evaluation_block, options[:scroll], object)
           elsif options[:always]
             wrap_always(evaluation_block, options[:always], object)
+          elsif options[:cache]
+            wrap_cache(evaluation_block, options[:cache], object)
           else
             Alba::Inertia.config.lazy_by_default ? evaluation_block : evaluation_block.call
           end
@@ -26,18 +32,36 @@ module Alba
           ::InertiaRails.always(&value_block)
         end
 
-        def wrap_optional(value_block, _opts, _object)
-          ::InertiaRails.optional(&value_block)
+        def wrap_cache(value_block, opts, _object)
+          if opts.is_a?(Hash)
+            raise ArgumentError, "cache: hash requires a :key" unless opts.key?(:key)
+            ::InertiaRails.cache(opts[:key], **opts.except(:key), &value_block)
+          else
+            ::InertiaRails.cache(opts, &value_block)
+          end
+        end
+
+        def wrap_optional(value_block, opts, _object)
+          if opts.is_a?(Hash)
+            options = opts.slice(:cache, *ONCE_KEYS)
+            ::InertiaRails.optional(**options, &value_block)
+          else
+            ::InertiaRails.optional(&value_block)
+          end
+        end
+
+        def wrap_once(value_block, opts, _object)
+          if opts.is_a?(Hash)
+            options = opts.slice(*ONCE_KEYS)
+            ::InertiaRails.once(**options, &value_block)
+          else
+            ::InertiaRails.once(&value_block)
+          end
         end
 
         def wrap_defer(value_block, opts, _object)
           if opts.is_a?(Hash)
-            options = {
-              group: opts[:group],
-              merge: opts[:merge],
-              deep_merge: opts[:deep_merge],
-              match_on: opts[:match_on]
-            }.compact
+            options = opts.slice(:group, :deep_merge, :merge, :match_on, :cache, *ONCE_KEYS)
 
             ::InertiaRails.defer(**options, &value_block)
           else
@@ -47,30 +71,32 @@ module Alba
 
         def wrap_merge(value_block, opts, _object)
           if opts.is_a?(Hash)
-            options = {match_on: opts[:match_on]}.compact
+            options = opts.slice(:match_on, *ONCE_KEYS)
             ::InertiaRails.merge(**options, &value_block)
           else
             ::InertiaRails.merge(&value_block)
           end
         end
 
-        def wrap_scroll(value_block, opts, object)
+        def wrap_scroll(value_block, opts, object, all_options = {})
+          extra = all_options.slice(:defer, :group)
+
           case opts
           when Symbol
             # scroll: :meta => extract metadata from object[:meta] or object.meta
             metadata = extract_from_object(object, opts)
-            ::InertiaRails.scroll(metadata: metadata, &value_block)
+            ::InertiaRails.scroll(metadata: metadata, **extra, &value_block)
           when Proc
             # scroll: -> { |obj| obj.meta } => call proc with object
             metadata = opts.call(object)
-            ::InertiaRails.scroll(metadata: metadata, &value_block)
+            ::InertiaRails.scroll(metadata: metadata, **extra, &value_block)
           when Hash
             options = build_scroll_options(opts, object)
             ::InertiaRails.scroll(**options, &value_block)
           when TrueClass
             # scroll: true => auto-detect metadata
             metadata = auto_detect_pagination_metadata(object)
-            ::InertiaRails.scroll(metadata: metadata, &value_block)
+            ::InertiaRails.scroll(metadata: metadata, **extra, &value_block)
           else
             raise ArgumentError, "Invalid scroll option. Expected Symbol, Proc, Hash, or true."
           end
@@ -86,7 +112,7 @@ module Alba
             opts[:scroll]
           end
 
-          {metadata: metadata}.merge(opts.slice(:wrapper, :page_name, :previous_page, :next_page, :current_page))
+          {metadata: metadata}.merge(opts.slice(:defer, :group, :wrapper, :page_name, :previous_page, :next_page, :current_page))
         end
 
         def extract_from_object(object, key)

data/lib/alba/inertia/resource.rb

@@ -56,15 +56,7 @@ module Alba
         #
         # @example Merge with custom options
         #   inertia_prop :metadata, merge: { match_on: :id, prepend: 'meta_' }
-        def inertia_prop(name, **kwargs)
-          options = {
-            optional: kwargs.delete(:optional) || false,
-            defer: kwargs.delete(:defer) || false,
-            merge: kwargs.delete(:merge) || false,
-            scroll: kwargs.delete(:scroll) || false,
-            always: kwargs.delete(:always) || false
-          }.select { |_k, v| v.present? }
-
+        def inertia_prop(name, **options)
           inertia_metadata[name] = options.freeze
           auto_typelize_from_inertia(name, options)
         end
@@ -121,7 +113,7 @@ module Alba
         result = {}
 
         self.class._attributes.each do |attr_name, attr_body|
-          attr_name_str = attr_name.to_s
+          attr_name_str = transform_key(attr_name)
 
           evaluation_block = build_evaluation_block(attr_name, attr_body)
 

data/lib/alba/inertia/version.rb

@@ -2,6 +2,6 @@
 
 module Alba
   module Inertia
-    VERSION = "0.1.2"
+    VERSION = "0.1.4"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: alba-inertia
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.4
 platform: ruby
 authors:
 - Svyatoslav Kryukov
@@ -91,7 +91,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.0
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Seamless integration between Alba and Inertia Rails.
 test_files: []