forest_admin_agent 1.37.4 → 1.38.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e658e8812d89132182a96392c58221793cf5991bd95b4c0d3170dff0676a693c
-  data.tar.gz: b7cf6705ebdda5d3785e78290f1b1f4b762b1eac7b157c999bbbde4b6206b8f3
+  metadata.gz: bbec2d5605e6d383151f61a3b58c602b0c65099685c03cd7e2f910146a563058
+  data.tar.gz: 53f010f4b995181820015c7bda91ef07a7d84bd8a7ee66fa9887f4e933bcbbbc
 SHA512:
-  metadata.gz: 2feb766efd70870058a92d79ebde8cc3a41cc83452767a7478f6d5a4e66aa72346c0b1208364696fe67c5b4d4378439797240cf387d4462ea198a4f5df521152
-  data.tar.gz: d49ef0aca2acdb55a4c6b8d5ac58861165017f424958787064635322ff2fe961ecaa6e206ecc80c4fc495a5986434615f1aa5b9b599d62ce390733b0a4bb89e8
+  metadata.gz: a34d395d4eab6ad9a034e9ef0b93b6737740a7a832da40e10ceab61787e5e3c2949776eb1c7bbefdd91cfdc175312e0e954e090c63804403e83e151080c6e16c
+  data.tar.gz: 18058de101b452b870c8ef90a2be2990ba07c197b2d64347e4e229d4f37156b26eaaf9cc96ab885911f5144e06ee939e9108044b85333eb8e97a6f442e22d2f7

data/lib/forest_admin_agent/routes/capabilities/collections.rb

@@ -65,6 +65,8 @@ module ForestAdminAgent
               nativeQueryConnections: connections,
               agentCapabilities: {
                 canUseProjectionOnGetOne: true,
+                canUseProjectionViaHeader: true,
+                canUseProjectionViaHeaderOnList: true,
                 canUseMultipleFieldsProjectionOnRelation: true
               }
             },

data/lib/forest_admin_agent/routes/resources/csv.rb

@@ -37,7 +37,7 @@ module ForestAdminAgent
             sort: QueryStringParser.parse_sort(context.collection, args),
             segment: QueryStringParser.parse_segment(context.collection, args)
           )
-          projection = QueryStringParser.parse_projection(context.collection, args)
+          projection = QueryStringParser.parse_projection_from_request(context.collection, args)
           filename = args[:params][:filename] || args[:params]['collection_name']
           filename += '.csv' unless /\.csv$/i.match?(filename)
           header = args[:params][:header]

data/lib/forest_admin_agent/routes/resources/related/csv_related.rb

@@ -32,8 +32,9 @@ module ForestAdminAgent
                 ]
               )
             )
-            projection = ForestAdminAgent::Utils::QueryStringParser.parse_projection_with_pks(context.child_collection,
-                                                                                              args)
+            projection = ForestAdminAgent::Utils::QueryStringParser.parse_projection_from_request(
+              context.child_collection, args
+            )
 
             # Get the parent record primary keys
             primary_key_values = Utils::Id.unpack_id(context.collection, args[:params]['id'], with_key: true)

data/lib/forest_admin_agent/routes/resources/store.rb

@@ -17,9 +17,10 @@ module ForestAdminAgent
         def handle_request(args = {})
           context = build(args)
           context.permissions.can?(:add, context.collection)
+          relations = authorized_linked_one_to_one_relations(args, context)
           data = format_attributes(args, context.collection)
           record = context.collection.create(context.caller, data)
-          link_one_to_one_relations(args, record, context)
+          link_one_to_one_relations(relations, record, context)
           id = ForestAdminDatasourceToolkit::Utils::Record.primary_keys(context.collection, record)
           filter = ForestAdminDatasourceToolkit::Components::Query::Filter.new(
             condition_tree: ConditionTree::ConditionTreeFactory.match_ids(context.collection, [id])
@@ -37,24 +38,63 @@ module ForestAdminAgent
           }
         end
 
-        def link_one_to_one_relations(args, record, context)
-          args[:params][:data][:relationships]&.map do |field, value|
-            schema = context.collection.schema[:fields][field]
-            next unless %w[OneToOne PolymorphicOneToOne].include?(schema.type)
+        private
 
-            primary_key_values = Utils::Id.unpack_id(context.collection, value['data']['id'], with_key: true)
-            foreign_collection = context.datasource.get_collection(schema.foreign_collection)
-            # Load the value that will be used as origin_key
-            origin_value = record[schema.origin_key_target]
+        def authorized_linked_one_to_one_relations(args, context)
+          linked_one_to_one_relations(args, context).map do |relation|
+            foreign_collection = relation[:foreign_collection]
 
-            # update new relation (may update zero or one records).
-            patch = { schema.origin_key => origin_value }
+            context.permissions.can?(:edit, foreign_collection)
+
+            relation.merge(
+              scope: context.permissions.get_scope(foreign_collection),
+              primary_key_values: Utils::Id.unpack_id(foreign_collection, relation[:id], with_key: true)
+            )
+          end
+        end
+
+        def linked_one_to_one_relations(args, context)
+          relationships = args.dig(:params, :data, :relationships) || {}
+
+          relationships.filter_map { |field, value| linked_one_to_one_relation(field, value, context) }
+        end
+
+        def linked_one_to_one_relation(field, value, context)
+          schema = context.collection.schema[:fields][field]
+          return unless %w[OneToOne PolymorphicOneToOne].include?(schema.type)
+
+          id = value.dig('data', 'id')
+          return if id.nil?
+
+          {
+            schema: schema,
+            foreign_collection: context.datasource.get_collection(schema.foreign_collection),
+            id: id
+          }
+        end
+
+        def link_one_to_one_relations(relations, record, context)
+          relations.each do |relation|
+            schema = relation[:schema]
+            foreign_collection = relation[:foreign_collection]
+
+            patch = { schema.origin_key => record[schema.origin_key_target] }
             if schema.type == 'PolymorphicOneToOne'
               patch[schema.origin_type_field] =
                 context.collection.name.gsub('__', '::')
             end
-            condition_tree = ConditionTree::ConditionTreeFactory.match_records(foreign_collection, [primary_key_values])
-            filter = Filter.new(condition_tree: condition_tree)
+
+            new_fk_owner = ConditionTree::ConditionTreeFactory.match_records(
+              foreign_collection, [relation[:primary_key_values]]
+            )
+            filter = Filter.new(
+              condition_tree: ConditionTree::ConditionTreeFactory.intersect(
+                [
+                  relation[:scope],
+                  new_fk_owner
+                ]
+              )
+            )
             foreign_collection.update(context.caller, filter, patch)
           end
         end

data/lib/forest_admin_agent/utils/query_string_parser.rb

@@ -47,6 +47,24 @@ module ForestAdminAgent
         raise BadRequestError, "Invalid projection: #{e.message}"
       end
 
+      def self.parse_projection_from_header(collection, args)
+        header = args.dig(:headers, 'HTTP_FOREST_PROJECTION')&.to_s&.strip
+
+        return if header.nil? || header.empty?
+
+        projection_fields = build_header_projection_fields(collection, header.split(',', -1).map(&:strip))
+
+        ForestAdminDatasourceToolkit::Validations::ProjectionValidator.validate?(collection, projection_fields)
+
+        Projection.new(projection_fields)
+      rescue ForestAdminDatasourceToolkit::Exceptions::ForestException => e
+        raise BadRequestError, "Invalid Forest-Projection header: #{e.message}"
+      end
+
+      def self.parse_projection_from_request(collection, args)
+        parse_projection_from_header(collection, args) || parse_projection(collection, args)
+      end
+
       def self.add_polymorphic_type_fields(collection, requested_field_names)
         polymorphic_relations = collection.schema[:fields].select { |_, field| field.type == 'PolymorphicManyToOne' }
 
@@ -83,6 +101,29 @@ module ForestAdminAgent
         end
       end
 
+      def self.build_header_projection_fields(collection, requested_paths)
+        if requested_paths.any? { |path| path.empty? || path.split(':', -1).any?(&:empty?) }
+          raise ForestAdminDatasourceToolkit::Exceptions::ValidationError, 'The projection contains an empty field.'
+        end
+
+        root_field_names = requested_paths.map { |path| path.split(':').first }
+        root_field_names_with_types = root_field_names.dup
+        add_polymorphic_type_fields(collection, root_field_names_with_types)
+
+        projection_fields = requested_paths.map do |path|
+          field_name, nested_path = path.split(':', 2)
+          field = get_field(collection, field_name)
+
+          if field.type == 'PolymorphicManyToOne' && (nested_path.nil? || nested_path == '*')
+            "#{field_name}:*"
+          else
+            path
+          end
+        end
+
+        projection_fields | (root_field_names_with_types - root_field_names)
+      end
+
       def self.get_field(collection, field_name)
         field = collection.schema[:fields][field_name]
         return field unless field.nil?
@@ -93,12 +134,11 @@ module ForestAdminAgent
               "Available fields are: [#{available_fields}]. " \
               'Please check if the field name is correct.'
       end
-      private_class_method :add_polymorphic_type_fields, :build_projection_fields, :get_field
+      private_class_method :add_polymorphic_type_fields, :build_projection_fields,
+                           :build_header_projection_fields, :get_field
 
       def self.parse_projection_with_pks(collection, args)
-        projection = parse_projection(collection, args)
-
-        projection.with_pks(collection)
+        parse_projection_from_request(collection, args).with_pks(collection)
       end
 
       def self.parse_pagination(args)

data/lib/forest_admin_agent/utils/schema/schema_emitter.rb

@@ -6,7 +6,7 @@ module ForestAdminAgent
     module Schema
       class SchemaEmitter
         LIANA_NAME = "agent-ruby"
-        LIANA_VERSION = "1.37.4"
+        LIANA_VERSION = "1.38.1"
 
         def self.generate(datasource)
           datasource.collections

data/lib/forest_admin_agent/version.rb

@@ -1,3 +1,3 @@
 module ForestAdminAgent
-  VERSION = "1.37.4"
+  VERSION = "1.38.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: forest_admin_agent
 version: !ruby/object:Gem::Version
-  version: 1.37.4
+  version: 1.38.1
 platform: ruby
 authors:
 - Matthieu
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-11 00:00:00.000000000 Z
+date: 2026-08-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport