forest_admin_datasource_toolkit 1.39.1 → 1.39.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e1e97e29e656eef0b13f32bc5d2500e03550abea29a29d926ea4ef6ecf15bda
-  data.tar.gz: 5ae7bf33e8978e2ccb64cc7d99185f765aee0c49e7d370748390783e714a9325
+  metadata.gz: af709d0c39e625f9f1a83754e7934f1a9b8cecbe58b984ff2d7f4158a74ef43a
+  data.tar.gz: 7501bec570294a030a5714099a28061090313faee2597ca978fed9d975007dd3
 SHA512:
-  metadata.gz: 35b738e75f57c477f3acbdbdc373d61b9b148bfa5185f57dd232ea245fa6734b3a95cd532c797a3c4405bbddc4a31ece4ad43ff46b23c444d8c23c3cbe1bb7f6
-  data.tar.gz: ed185039912440f8f33c2dd39d079a6825fa72bff9e57dbe5b4298b030a490fb2069573276c342ce75d974102922490d4d3e74f0fee47ed7f641b072f85308b0
+  metadata.gz: b3a10a88b66528f98d98492bfb6fc0f32a8c73fd686658064f9d468638c65b6efc24f8a67a049dd9b397d9ed3359295f7727b66352dfc0b1f3a4cbad7f0e1f8f
+  data.tar.gz: 6e30813f7804fcfa01f24db16a4e88be5af61716ac1e3030acc0222809e42a3fde8c97e0cb8cfadb2c9524b51ede3cf314c7ae8464a821e0d280569ae9b30ab6

data/lib/forest_admin_datasource_toolkit/decorators/collection_decorator.rb

@@ -77,6 +77,14 @@ module ForestAdminDatasourceToolkit
         @child_collection.render_chart(caller, name, record_id, parameters)
       end
 
+      # Which fields a search will actually reach, and the collection each one ends on. +nil+ means
+      # the collection cannot say, which a caller must read as "unknown", never as "none".
+      def searched_fields(search, extended)
+        return nil unless @child_collection.is_a?(CollectionDecorator)
+
+        @child_collection.searched_fields(search, extended)
+      end
+
       protected
 
       def mark_schema_as_dirty

data/lib/forest_admin_datasource_toolkit/utils/field_path.rb

@@ -0,0 +1,52 @@
+module ForestAdminDatasourceToolkit
+  module Utils
+    class FieldPath
+      POLYMORPHIC_MANY_TO_ONE = 'PolymorphicManyToOne'.freeze
+
+      # The collections whose column a path ends on — the ones a read permission applies to.
+      # Collections crossed on the way are joins, not read targets, so they are not returned.
+      #
+      # Several names come back for a path ending on a polymorphic relation: it carries no
+      # discriminant, so any record may resolve to any of its targets and none can be ruled out. The
+      # list is empty for a polymorphic relation declaring no target at all, which the caller counts
+      # as denied — an empty list is a path that resolves to nothing, not a path that needs nothing.
+      #
+      # A prefix naming no relation raises rather than falling back to +collection+. The caller pins
+      # the collection it asked about to readable, so falling back would turn "this path does not
+      # resolve" into "this path is allowed".
+      #
+      # A path with no prefix at all is a column of +collection+ itself, and so is allowed. Two
+      # customisations reach a related collection through one deliberately: +import_field+, and an
+      # +add_field+ whose dependencies cross a relation, both register a root-level column that the
+      # operator and sorting layers rewrite into a relation path below this guard. Like a scope or a
+      # +replace_search+, they are the customer's own choice of what a role reaches through a column
+      # it can read.
+      def self.leaf_collection_names(collection, path)
+        index = path.index(':')
+
+        return [collection.name] if index.nil?
+
+        relation = relation_at(collection, path[0...index])
+
+        return relation.foreign_collections if relation.type == POLYMORPHIC_MANY_TO_ONE
+
+        leaf_collection_names(
+          collection.datasource.get_collection(relation.foreign_collection),
+          path[(index + 1)..]
+        )
+      end
+
+      def self.relation_at(collection, name)
+        field = collection.schema[:fields][name]
+
+        if field.nil? || field.type == 'Column'
+          raise Exceptions::ForestException, "Relation not found: '#{collection.name}.#{name}'"
+        end
+
+        field
+      end
+
+      private_class_method :relation_at
+    end
+  end
+end

data/lib/forest_admin_datasource_toolkit/version.rb

@@ -1,3 +1,3 @@
 module ForestAdminDatasourceToolkit
-  VERSION = "1.39.1"
+  VERSION = "1.39.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: forest_admin_datasource_toolkit
 version: !ruby/object:Gem::Version
-  version: 1.39.1
+  version: 1.39.2
 platform: ruby
 authors:
 - Matthieu
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-20 00:00:00.000000000 Z
+date: 2026-08-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -217,6 +217,7 @@ files:
 - lib/forest_admin_datasource_toolkit/schema/relations/polymorphic_one_to_many_schema.rb
 - lib/forest_admin_datasource_toolkit/schema/relations/polymorphic_one_to_one_schema.rb
 - lib/forest_admin_datasource_toolkit/utils/collection.rb
+- lib/forest_admin_datasource_toolkit/utils/field_path.rb
 - lib/forest_admin_datasource_toolkit/utils/hash_helper.rb
 - lib/forest_admin_datasource_toolkit/utils/record.rb
 - lib/forest_admin_datasource_toolkit/utils/schema.rb