iknow_view_models 3.12.1 → 3.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 38a806928f1c5c2d76aadb5970b72abeabb5f579bde7164ba0b90de9ed6781ea
-  data.tar.gz: fa7c33062381a8414be49bc82b87bc938f5bdad278f10f55cb5b64aa0115eb4f
+  metadata.gz: cf46376eaf22e04e38fb4b841c10ee273422c4927a1402b4cd2ca4d53f548cb7
+  data.tar.gz: eb83782759ccdc0259c25bf15eca93469272a947b0177c03cb739f478be0733b
 SHA512:
-  metadata.gz: 9c1b31614c56224a94331c75ff2e44080acda5d92aced69ab0e73dbc2fece60e710ae2e066f69fdf42f0726cd1c80ab7ec762ed24cac36e1343f54f4584bff60
-  data.tar.gz: fd9b38a254a62fbc67cbe2a0c668e8e3a49ca2474df4a39bf9f1344e60076aaefb8ea01d7e5196a1408a1bfaa2ab3f1f2ec624ea050bca16098b89e78ed3d919
+  metadata.gz: 6edef87440a300016dd2044330e25d1927d161a7706abb4fab86cfd1cffde93e980ef978097006364f7fa4330c4b669342c04f3c3768645832faa0b7f8742f99
+  data.tar.gz: a44050a5c1aebc470ab8c96e027935463b6dd05f3f796f828be33b40ad3af9cd9148fcddbc69aeadb00b1466b802b049c51378f05e63af2c67143838c74a8308

data/lib/iknow_view_models/version.rb

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

data/lib/view_model/active_record/update_data.rb

@@ -635,7 +635,12 @@ class ViewModel::ActiveRecord
         deps[association_data.direct_reflection.name.to_s] = referenced_deps
       end
 
-      DeepPreloader::Spec.new(deps)
+      deserialization_includes = viewmodel_class.deserialization_includes
+      unless deserialization_includes.is_a?(DeepPreloader::AbstractSpec)
+        deserialization_includes = DeepPreloader::Spec.parse(deserialization_includes)
+      end
+
+      DeepPreloader::Spec.new(deps).merge!(deserialization_includes)
     end
 
     def viewmodel_reference

data/lib/view_model.rb

@@ -192,12 +192,21 @@ class ViewModel
     end
 
     # If this viewmodel represents an AR model, what associations does it make
-    # use of? Returns a includes spec appropriate for DeepPreloader, either as
-    # AR-style nested hashes or DeepPreloader::Spec.
+    # use of during serialization? Returns a includes spec appropriate for
+    # DeepPreloader, either as AR-style nested hashes or DeepPreloader::Spec.
     def eager_includes(include_referenced: true)
       {}
     end
 
+    # If this viewmodel represents an AR model, what associations does it make
+    # use of during deserialization? By default all mentioned associations are
+    # preloaded, however access controls and hooks may benefit from additional
+    # preloading. Returns a includes spec appropriate for DeepPreloader, either
+    # as AR-style nested hashes or DeepPreloader::Spec.
+    def deserialization_includes
+      {}
+    end
+
     # ViewModel can serialize ViewModels, Arrays and Hashes of ViewModels, and
     # relies on Jbuilder#merge! for other values (e.g. primitives).
     def serialize(target, json, serialize_context: new_serialize_context)

data/test/unit/view_model/active_record/belongs_to_test.rb

@@ -443,4 +443,26 @@ class ViewModel::ActiveRecord::BelongsToTest < ActiveSupport::TestCase
       end
     end
   end
+
+  class DeserializationIncludeTest < ActiveSupport::TestCase
+    include ARVMTestUtilities
+    include ViewModelSpecHelpers::Base
+
+    def model_attributes
+      super.merge(
+        viewmodel: ->(_v) {
+          def self.deserialization_includes
+            :child
+          end
+        }
+      )
+    end
+
+    def test_extra_dependencies
+      viewmodel_class # realize lazy dependency
+
+      root_updates, _ref_updates = ViewModel::ActiveRecord::UpdateData.parse_hashes([{ '_type' => 'Model' }])
+      assert_equal(DeepPreloader::Spec.new('child' => nil), root_updates.first.preload_dependencies)
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: iknow_view_models
 version: !ruby/object:Gem::Version
-  version: 3.12.1
+  version: 3.13.0
 platform: ruby
 authors:
 - iKnow Team
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-10-09 00:00:00.000000000 Z
+date: 2024-12-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack