forest_admin_agent 1.37.4 → 1.38.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e658e8812d89132182a96392c58221793cf5991bd95b4c0d3170dff0676a693c
-  data.tar.gz: b7cf6705ebdda5d3785e78290f1b1f4b762b1eac7b157c999bbbde4b6206b8f3
+  metadata.gz: 5455a6164932af84cf535d72cd896814fcb24a83106cae4c6efbf94d3f15f650
+  data.tar.gz: f31a0a6cde3793cd7bc2f5bfc1c2462a0001d4e80e414e7433064f2907dff45d
 SHA512:
-  metadata.gz: 2feb766efd70870058a92d79ebde8cc3a41cc83452767a7478f6d5a4e66aa72346c0b1208364696fe67c5b4d4378439797240cf387d4462ea198a4f5df521152
-  data.tar.gz: d49ef0aca2acdb55a4c6b8d5ac58861165017f424958787064635322ff2fe961ecaa6e206ecc80c4fc495a5986434615f1aa5b9b599d62ce390733b0a4bb89e8
+  metadata.gz: 929f4669e1b73c51b615f0259a6b34e6cfa59cb89c7e9dde693c7c47238b4c5b2fe608d5a3eceb73d6ed025fe5d5a83a33759920187c61bb1eddd3b0ab239bf1
+  data.tar.gz: 638dd7596eae9fde1b272e5389d3da042e0aaf3e12080fbdf449866a61a8535a75ae8d46cbf39c5c3eed56792f249c7146d770179a976fe0961b5e6c6b445b02

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/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.0"
 
         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.0"
 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.0
 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-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport