forest_admin_rails 1.26.3 → 1.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 39f11eb40b1841e1953642ef5ca6dcb9802e44057ddc6b4c75263d300ed09e01
-  data.tar.gz: c848ad601825470528a781f8caf5bc9edf7d3ca0b3563f589128ccbbbfb3e494
+  metadata.gz: 3104918c786deec910c0eb28a201002eb3181ae7e7d322891b1319870caf7283
+  data.tar.gz: 33923c4d8bf895af848bfa63dc24c0d425623e85736f8f0176251b2142c4d9d0
 SHA512:
-  metadata.gz: 8b8260e3351c961081aee921074cb63eeed14afda0b9459c6c9984a995ecb9e963b05f672e6b67a4f86181d010e0eda36ea5692be1dc49e908e20f7a906a98cb
-  data.tar.gz: 2a7eb3ae31b4361e24dc1fc280f81e3a441707f2b27ed17c5d2381523bc9a0a51e3e8b6431232a73733b7cc839b5ade0d88af25cd76eb018e8838082528d4979
+  metadata.gz: 0a00bc444b99799b50dc54d432a080c4949e665230fa48e1164c0f756e089880b013af9cba63feb0be0e32493b869068d7bab6a42e00ab2fdf1a283802632cd0
+  data.tar.gz: 0ae0572a332551eb9fe2340884cdd6ee26de9964c9dd9440a8eb9da216f9229c9d0a3a84e110204eb57b2426b3a46eedb3feb278d30d535048a42d8cefba9e50

data/lib/forest_admin/types.rb

@@ -128,6 +128,17 @@ module ForestAdmin
     # Plugin - base class for creating custom plugins
     Plugin = ForestAdminDatasourceCustomizer::Plugins::Plugin
 
+    # ActiveStoragePlugin - plugin to expose Active Storage attachments as File fields
+    # Lazy-loaded because Zeitwerk may not have autoloaded it yet when types.rb is required
+    def self.const_missing(name)
+      if name == :ActiveStoragePlugin
+        require 'forest_admin_rails/plugins/active_storage'
+        const_set(:ActiveStoragePlugin, ForestAdminRails::Plugins::ActiveStorage)
+      else
+        super
+      end
+    end
+
     # ============================================
     # Additional Context Classes
     # ============================================

data/lib/forest_admin_rails/plugins/active_storage.rb

@@ -0,0 +1,130 @@
+require 'base64'
+require 'cgi'
+require 'rack/mime'
+
+module ForestAdminRails
+  module Plugins
+    class ActiveStorage < ForestAdminDatasourceCustomizer::Plugins::Plugin
+      ACTIVE_STORAGE_COLLECTIONS = %w[
+        ActiveStorage__Attachment
+        ActiveStorage__Blob
+        ActiveStorage__VariantRecord
+      ].freeze
+
+      def run(datasource_customizer, _collection_customizer = nil, options = {})
+        datasource_customizer.collections.each do |name, collection|
+          next if options[:only] && !options[:only].include?(name)
+          next if options[:except]&.include?(name)
+
+          add_attachment_fields(collection, options)
+        end
+
+        remove_active_storage_collections(datasource_customizer) if options.fetch(:hide_internal_collections, true)
+      end
+
+      private
+
+      def remove_active_storage_collections(datasource_customizer)
+        ACTIVE_STORAGE_COLLECTIONS.each do |collection_name|
+          next unless datasource_customizer.collections.key?(collection_name)
+
+          datasource_customizer.remove_collection(collection_name)
+        end
+      end
+
+      def add_attachment_fields(collection, options)
+        model_class = find_model_class(collection)
+        return unless model_class
+        return unless defined?(::ActiveStorage) && model_class.respond_to?(:reflect_on_all_attachments)
+
+        model_class.reflect_on_all_attachments
+                   .select { |a| a.macro == :has_one_attached }
+                   .each do |attachment|
+          name = attachment.name.to_s
+          hide_attachment_relations(collection, name)
+          add_file_field(collection, model_class, name, options.fetch(:download_images_on_list, false))
+        end
+      end
+
+      def hide_attachment_relations(collection, attachment_name)
+        %W[#{attachment_name}_attachment #{attachment_name}_blob].each do |relation_name|
+          next unless collection.schema[:fields].key?(relation_name)
+
+          collection.remove_field(relation_name)
+        end
+      end
+
+      def add_file_field(collection, model_class, attachment_name, download_images_on_list)
+        return if collection.schema[:fields][attachment_name]
+
+        collection.add_field(attachment_name,
+                             ForestAdminDatasourceCustomizer::Decorators::Computed::ComputedDefinition.new(
+                               column_type: 'File',
+                               dependencies: ['id'],
+                               values: lambda { |records, _ctx|
+                                 compute_values(records, model_class, attachment_name, download_images_on_list)
+                               }
+                             ))
+
+        collection.replace_field_writing(attachment_name) do |value, context|
+          handle_write(value, context, model_class, attachment_name)
+        end
+      end
+
+      def compute_values(records, model_class, attachment_name, download_images_on_list)
+        ids = records.map { |r| r['id'] }
+        models = model_class
+                 .where(id: ids)
+                 .includes(:"#{attachment_name}_attachment", :"#{attachment_name}_blob")
+                 .index_by(&:id)
+
+        records.map do |record|
+          model = models[record['id']]
+          next nil unless model&.public_send(attachment_name)&.attached?
+
+          blob = model.public_send(attachment_name).blob
+
+          if records.length == 1 || (download_images_on_list && blob.content_type&.start_with?('image/'))
+            content = blob.download
+            "data:#{blob.content_type};name=#{CGI.escape(blob.filename.to_s)};base64,#{Base64.strict_encode64(content)}"
+          else
+            "data:#{blob.content_type};name=#{CGI.escape(blob.filename.to_s)};base64,"
+          end
+        end
+      end
+
+      def handle_write(value, context, model_class, attachment_name)
+        record_id = context.filter&.condition_tree&.value
+        return {} unless record_id
+
+        record = model_class.find(record_id)
+
+        if value.nil? || value.to_s.strip.empty?
+          record.public_send(attachment_name).purge if record.public_send(attachment_name).attached?
+        else
+          parsed = ForestAdminAgent::Utils::Schema::ForestValueConverter.parse_data_uri(value)
+          if parsed
+            fallback_extension = Rack::Mime::MIME_TYPES.invert[parsed['mime_type']] || '.bin'
+            record.public_send(attachment_name).attach(
+              io: StringIO.new(parsed['buffer']),
+              filename: parsed['name'] || "#{attachment_name}#{fallback_extension}",
+              content_type: parsed['mime_type']
+            )
+          end
+        end
+        {}
+      end
+
+      def find_model_class(collection)
+        current = collection.respond_to?(:collection) ? collection.collection : collection
+        loop do
+          return current.model if current.respond_to?(:model) && current.model.is_a?(Class)
+          break unless current.respond_to?(:child_collection)
+
+          current = current.child_collection
+        end
+        nil
+      end
+    end
+  end
+end

data/lib/forest_admin_rails/version.rb

@@ -1,3 +1,3 @@
 module ForestAdminRails
-  VERSION = "1.26.3"
+  VERSION = "1.27.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: forest_admin_rails
 version: !ruby/object:Gem::Version
-  version: 1.26.3
+  version: 1.27.0
 platform: ruby
 authors:
 - Matthieu
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-24 00:00:00.000000000 Z
+date: 2026-04-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -185,6 +185,7 @@ files:
 - lib/forest_admin/types.rb
 - lib/forest_admin_rails.rb
 - lib/forest_admin_rails/engine.rb
+- lib/forest_admin_rails/plugins/active_storage.rb
 - lib/forest_admin_rails/version.rb
 - lib/generators/forest_admin_rails/install_generator.rb
 - lib/generators/forest_admin_rails/templates/create_agent.rb