forest_admin_agent 1.38.2 → 1.39.0

data/lib/forest_admin_agent/serializer/forest_serializer_override.rb

@@ -54,23 +54,24 @@ module ForestAdminAgent
               # Full linkage: a request for comments.author MUST automatically include comments
               # in the response.
               objects = is_collection ? object : [object]
+
+              relation = ForestAdminAgent::Facades::Container.datasource
+                                                             .get_collection(options[:class_name].gsub('::', '__'))
+                                                             .schema[:fields][attribute_name]
+              if relation.type == 'PolymorphicManyToOne'
+                relation_class_name = root_object[relation.foreign_key_type_field]
+              else
+                relation_class_name = ForestAdminAgent::Facades::Container.datasource.get_collection(relation.foreign_collection).name
+              end
+
+              related_collection_options = options.merge(class_name: relation_class_name)
+
               if child_inclusion_tree[:_include] == true
                 # Include the current level objects if the _include attribute exists.
                 # If it is not set, that indicates that this is an inner path and not a leaf and will
                 # be followed by the recursion below.
                 objects.each do |obj|
-                  relation = ForestAdminAgent::Facades::Container.datasource
-                                                                 .get_collection(options[:class_name].gsub('::', '__'))
-                                                                 .schema[:fields][attribute_name]
-                  if relation.type == 'PolymorphicManyToOne'
-                    relation_class_name = root_object[relation.foreign_key_type_field]
-                  else
-                    relation_class_name = ForestAdminAgent::Facades::Container.datasource.get_collection(relation.foreign_collection).name
-                  end
-
-                  option_relation = options.clone
-                  option_relation[:class_name] = relation_class_name
-                  obj_serializer = JSONAPI::Serializer.find_serializer(obj, option_relation)
+                  obj_serializer = JSONAPI::Serializer.find_serializer(obj, related_collection_options)
 
                   # Use keys of ['posts', '1'] for the results to enforce uniqueness.
                   # Spec: A compound document MUST NOT include more than one resource object for each
@@ -105,7 +106,7 @@ module ForestAdminAgent
 
               # For each object we just loaded, find all deeper recursive relationships.
               objects.each do |obj|
-                find_recursive_relationships(obj, child_inclusion_tree, results, options)
+                find_recursive_relationships(obj, child_inclusion_tree, results, related_collection_options)
               end
             end
             nil

data/lib/forest_admin_agent/utils/caller_parser.rb

@@ -18,6 +18,10 @@ module ForestAdminAgent
         @token_data = decode_token
         @token_data[:timezone] = extract_timezone
         @token_data[:request] = { ip: @args[:headers]['action_dispatch.remote_ip'].to_s }
+        # One id per request, generated by the agent, shared by every operation it triggers (used to
+        # correlate the audit trail) and echoed back to the client in the response header.
+        # See ForestAdminAgent::Http::CorrelationId.
+        @token_data[:request_id] = Http::CorrelationId.current
         project, environment = extract_forest_context
         @token_data[:project] = project
         @token_data[:environment] = environment

data/lib/forest_admin_agent/utils/query_string_parser.rb

@@ -9,6 +9,7 @@ module ForestAdminAgent
 
       DEFAULT_ITEMS_PER_PAGE = '15'.freeze
       DEFAULT_PAGE_TO_SKIP = '1'.freeze
+      POLYMORPHIC_TARGET_WILDCARD = '*'.freeze
 
       def self.parse_condition_tree(collection, args)
         filters = begin
@@ -88,7 +89,7 @@ module ForestAdminAgent
           when 'Column'
             field_name
           when 'PolymorphicManyToOne'
-            "#{field_name}:*"
+            "#{field_name}:#{POLYMORPHIC_TARGET_WILDCARD}"
           else
             relation_fields = args.dig(:params, :fields, field_name)
 
@@ -110,18 +111,63 @@ module ForestAdminAgent
         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)
+        projection_fields = requested_paths.map { |path| expand_polymorphic_leaf(collection, path) }
 
-          if field.type == 'PolymorphicManyToOne' && (nested_path.nil? || nested_path == '*')
-            "#{field_name}:*"
-          else
-            path
+        projection_fields |
+          (root_field_names_with_types - root_field_names) |
+          nested_polymorphic_linkage_fields(collection, projection_fields)
+      end
+
+      def self.expand_polymorphic_leaf(collection, path)
+        segments = path.split(':')
+        leaf_index = segments.size - 1
+
+        each_field_along_path(collection, segments) do |field, index|
+          return "#{path}:#{POLYMORPHIC_TARGET_WILDCARD}" if polymorphic_many_to_one?(field) && index == leaf_index
+        end
+
+        path
+      end
+
+      def self.nested_polymorphic_linkage_fields(collection, projection_fields)
+        projection_fields.flat_map do |path|
+          segments = path.split(':')
+
+          each_field_along_path(collection, segments).flat_map do |field, index|
+            next [] unless polymorphic_many_to_one?(field) && index.positive?
+
+            polymorphic_linkage_columns(field, segments[0...index])
           end
         end
+      end
+
+      def self.polymorphic_linkage_columns(field, relation_path)
+        [field.foreign_key_type_field, field.foreign_key].map { |column| (relation_path + [column]).join(':') }
+      end
+
+      def self.each_field_along_path(collection, segments)
+        return to_enum(:each_field_along_path, collection, segments) unless block_given?
+
+        current_collection = collection
+
+        segments.each_with_index do |segment, index|
+          field = field_along_path(current_collection, segment, root: index.zero?)
+          break if field.nil?
+
+          yield field, index
+
+          break unless field.respond_to?(:foreign_collection)
+
+          current_collection = collection.datasource.get_collection(field.foreign_collection)
+        end
+      end
+
+      def self.field_along_path(collection, segment, root:)
+        root ? get_field(collection, segment) : collection.schema[:fields][segment]
+      end
 
-        projection_fields | (root_field_names_with_types - root_field_names)
+      def self.polymorphic_many_to_one?(field)
+        field.type == 'PolymorphicManyToOne'
       end
 
       def self.get_field(collection, field_name)
@@ -135,7 +181,10 @@ module ForestAdminAgent
               'Please check if the field name is correct.'
       end
       private_class_method :add_polymorphic_type_fields, :build_projection_fields,
-                           :build_header_projection_fields, :get_field
+                           :build_header_projection_fields, :get_field,
+                           :expand_polymorphic_leaf, :nested_polymorphic_linkage_fields,
+                           :polymorphic_linkage_columns, :each_field_along_path,
+                           :field_along_path, :polymorphic_many_to_one?
 
       def self.parse_projection_with_pks(collection, args)
         parse_projection_from_request(collection, args).with_pks(collection)

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.38.2"
+        LIANA_VERSION = "1.39.0"
 
         def self.generate(datasource)
           datasource.collections

data/lib/forest_admin_agent/version.rb

@@ -1,3 +1,3 @@
 module ForestAdminAgent
-  VERSION = "1.38.2"
+  VERSION = "1.39.0"
 end

data/lib/forest_admin_agent.rb

@@ -4,7 +4,11 @@ require 'zeitwerk'
 
 loader = Zeitwerk::Loader.for_gem
 loader.inflector.inflect('oauth2' => 'OAuth2')
+loader.inflector.inflect('sql' => 'Sql')
 loader.inflector.inflect('sse_cache_invalidation' => 'SSECacheInvalidation')
+# ActiveRecord is only needed by agents configuring an audit-trail database, and Rails eager loads
+# every gem loader (Zeitwerk::Loader.eager_load_all), so these files must stay strictly autoloaded.
+loader.do_not_eager_load("#{__dir__}/forest_admin_agent/audit_trail/sql")
 loader.setup
 
 module ForestAdminAgent

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: forest_admin_agent
 version: !ruby/object:Gem::Version
-  version: 1.38.2
+  version: 1.39.0
 platform: ruby
 authors:
 - Matthieu
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-13 00:00:00.000000000 Z
+date: 2026-08-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -330,10 +330,26 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".rspec"
+- AUDIT_TRAIL.md
 - Rakefile
 - forest_admin
 - forest_admin_agent.gemspec
 - lib/forest_admin_agent.rb
+- lib/forest_admin_agent/audit_trail.rb
+- lib/forest_admin_agent/audit_trail/action_capture.rb
+- lib/forest_admin_agent/audit_trail/audit_record.rb
+- lib/forest_admin_agent/audit_trail/capture.rb
+- lib/forest_admin_agent/audit_trail/diff.rb
+- lib/forest_admin_agent/audit_trail/record_state.rb
+- lib/forest_admin_agent/audit_trail/recording.rb
+- lib/forest_admin_agent/audit_trail/snapshots.rb
+- lib/forest_admin_agent/audit_trail/sql/audit_connection_base.rb
+- lib/forest_admin_agent/audit_trail/sql/audit_log.rb
+- lib/forest_admin_agent/audit_trail/sql/field_filter.rb
+- lib/forest_admin_agent/audit_trail/sql/migrations.rb
+- lib/forest_admin_agent/audit_trail/sql/migrator.rb
+- lib/forest_admin_agent/audit_trail/sql/text_search.rb
+- lib/forest_admin_agent/audit_trail/store.rb
 - lib/forest_admin_agent/auth/auth_manager.rb
 - lib/forest_admin_agent/auth/oauth2/forest_provider.rb
 - lib/forest_admin_agent/auth/oauth2/forest_resource_owner.rb
@@ -344,6 +360,8 @@ files:
 - lib/forest_admin_agent/facades/whitelist.rb
 - lib/forest_admin_agent/http/Exceptions/business_error.rb
 - lib/forest_admin_agent/http/Exceptions/http_exception.rb
+- lib/forest_admin_agent/http/correlation_id.rb
+- lib/forest_admin_agent/http/correlation_id_middleware.rb
 - lib/forest_admin_agent/http/error_translator.rb
 - lib/forest_admin_agent/http/forest_admin_api_requester.rb
 - lib/forest_admin_agent/http/router.rb
@@ -357,6 +375,9 @@ files:
 - lib/forest_admin_agent/routes/charts/charts.rb
 - lib/forest_admin_agent/routes/query_handler.rb
 - lib/forest_admin_agent/routes/request_context.rb
+- lib/forest_admin_agent/routes/resources/audit_trail.rb
+- lib/forest_admin_agent/routes/resources/audit_trail_correlation.rb
+- lib/forest_admin_agent/routes/resources/audit_trail_route.rb
 - lib/forest_admin_agent/routes/resources/count.rb
 - lib/forest_admin_agent/routes/resources/csv.rb
 - lib/forest_admin_agent/routes/resources/delete.rb