eluvia-base 3.40.0 → 3.41.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dcf7c769d60f4347beee0d63aff1e1e8944e5fb2412985f531465dd833cfe58e
-  data.tar.gz: dc7491fcac983ef84e9f33396139370ce94fb65ce8718742acc4806d4e35e0b6
+  metadata.gz: 8d7c48fd8f44bcda78e3e702b68e2d1fc1da1f16c5c5231f9243c1a82c3132ca
+  data.tar.gz: 9eba98e2363832aea7e3015cfdc9312b7fb88fccae0d45def95cb34b8606a0ef
 SHA512:
-  metadata.gz: 1a8eff124c578195160772b542e7ece4419b76ada79214f3b7d7ba3cb5c24768249b8d8c24ea207e37a33e6dc5d4d3b7196f83d369df428ae9724b36702af1e4
-  data.tar.gz: 2df71bbb4195fde554b62bc8052d02894be13b14c652325f08af43b94d4b23385499bf0dbe5847ae16786519e59de04be8b6d8a65f4e734f8202bc99f793a55a
+  metadata.gz: eb92181c8003d8da9d2647734357877fc8e75aed3ae362ccd8fe91dad0da757f28648fbe1fffd9fcadb367ae97b5884670ae202847a5bf8842730b45b5355438
+  data.tar.gz: c6aa908b43d905ba1080d12b5c6c2cbeda73917c00a58ae45fbd3ef3c9ddf293ab87726036945ff27fce510dbac61d4ced691a1341d2997babeaa4c0c2e6b0d6

data/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.41.0] — 2026-10-27
+
+### Added
+- `Eluvia::ActiveRecord::FileArrayAttribute` registers each `file_array_attr` like `file_attr`
+  does: `file_array_attrs`, `file_array_attr_names`, `has_file_array_attr?` and
+  `find_file_array_attr` return its `underlying_attachments`, `underlying_filter`, `nature` and
+  `append_only` (HAB-991).
+- `append_only:` option on `file_array_attr`: the setter takes a list of flat
+  `{filename, content}` files, attaches each one with content, never removes an existing
+  attachment, and ignores `nil`. Requires `underlying_attachments` (HAB-991).
+
 ## [3.40.0] — 2026-09-23
 
 ### Added

data/lib/eluvia/active_record/file_array_attribute.rb

@@ -6,6 +6,30 @@ module Eluvia
 
       class_methods do
 
+        # *********************************************************************
+        # Attribute store methods
+        # *********************************************************************
+
+        def _file_array_attrs
+          @file_array_attrs ||= {}
+        end
+
+        def file_array_attrs
+          _file_array_attrs.values
+        end
+
+        def file_array_attr_names
+          file_array_attrs.map { |a| a[:attr_name] }
+        end
+
+        def has_file_array_attr?(attr_name)
+          _file_array_attrs.key?(attr_name.to_sym)
+        end
+
+        def find_file_array_attr(attr_name)
+          _file_array_attrs.fetch(attr_name.to_sym, nil)
+        end
+
         # *********************************************************************
         # Attribute definition methods for file array
         # *********************************************************************
@@ -16,78 +40,101 @@ module Eluvia
         # @param underlying_attachments [Symbol, nil] Name of the attribute holding underlying Active Storage attachments
         # @param underlying_filter [Proc, nil] Optional filter to be applied to scope underlying attachments
         # @param nature [Symbol] Nature of file attribute (:file, :image, etc.)
+        # @param append_only [Boolean] Whether the setter only attaches new `{filename, content}` files and never removes existing ones
         # @param declare [Boolean] Whether to declare the underlying attribute
-        def file_array_attr(attr_name, underlying_attachments: nil, underlying_filter: nil, nature: :file, declare: false)
+        def file_array_attr(attr_name, underlying_attachments: nil, underlying_filter: nil, nature: :file, append_only: false, declare: false)
           attr_name = attr_name.to_sym
           nature = nature.to_sym
 
+          raise ArgumentError, "`append_only` file array attribute `#{attr_name}` requires `underlying_attachments`." if append_only && !underlying_attachments
+
           # Define it using "has many" attribute
           if declare
             has_many_attr(attr_name, nature == :image ? 'Eluvia::ImageWrapper' : 'Eluvia::FileWrapper')
           end
 
+          # Register metadata
+          self._file_array_attrs[attr_name] = {
+            attr_name: attr_name,
+            underlying_attachments: underlying_attachments,
+            underlying_filter: underlying_filter,
+            nature: nature,
+            append_only: append_only
+          }
+
           # *******************************************************************
           # Dynamically defined instance methods for file array
           # *******************************************************************
 
           if underlying_attachments
 
-            # Set method
-            define_method(:"#{attr_name}=") do |new_values|
-
-              # Check input
-              raise Eluvia::Errors::BadRequest.new("Invalid value for attribute `#{attr_name}`, expecting Array.") unless new_values.is_a?(::Array)
-
-              # Current values
-              current_values = self.send(attr_name)
-              current_ids = current_values.map(&:id)
-              new_ids = []
-
-              # Create missing attachments
-              new_values.each do |value|
-                # Normalize and check value
-                if value.is_a?(::Hash)
-                  if nature == :image
-                    value = Eluvia::ImageWrapper.map(value)
-                  else
-                    value = Eluvia::FileWrapper.map(value)
+            if append_only
+
+              # Set method - attaches each new file, leaves the existing attachments untouched
+              define_method(:"#{attr_name}=") do |new_values|
+                append_file_array_uploads(attr_name, underlying_attachments, new_values)
+              end
+
+            else
+
+              # Set method
+              define_method(:"#{attr_name}=") do |new_values|
+
+                # Check input
+                raise Eluvia::Errors::BadRequest.new("Invalid value for attribute `#{attr_name}`, expecting Array.") unless new_values.is_a?(::Array)
+
+                # Current values
+                current_values = self.send(attr_name)
+                current_ids = current_values.map(&:id)
+                new_ids = []
+
+                # Create missing attachments
+                new_values.each do |value|
+                  # Normalize and check value
+                  if value.is_a?(::Hash)
+                    if nature == :image
+                      value = Eluvia::ImageWrapper.map(value)
+                    else
+                      value = Eluvia::FileWrapper.map(value)
+                    end
                   end
-                end
-                raise Eluvia::Errors::BadRequest.new("Invalid value for attribute `#{attr_name}[]`, expecting Eluvia::FileWrapper or Eluvia::ImageWrapper.") unless value.is_a?(Eluvia::FileWrapper) || value.is_a?(Eluvia::ImageWrapper)
-                raise Eluvia::Errors::BadRequest.new("Invalid value for attribute `#{attr_name}[].file`, can't be blank.") if value.file.blank?
+                  raise Eluvia::Errors::BadRequest.new("Invalid value for attribute `#{attr_name}[]`, expecting Eluvia::FileWrapper or Eluvia::ImageWrapper.") unless value.is_a?(Eluvia::FileWrapper) || value.is_a?(Eluvia::ImageWrapper)
+                  raise Eluvia::Errors::BadRequest.new("Invalid value for attribute `#{attr_name}[].file`, can't be blank.") if value.file.blank?
 
-                # Keep track of new ids
-                new_ids << value.id if value.id
+                  # Keep track of new ids
+                  new_ids << value.id if value.id
 
-                # Retrieve filename and content
-                filename = value.file&.filename
-                content = value.file&.content
+                  # Retrieve filename and content
+                  filename = value.file&.filename
+                  content = value.file&.content
 
-                # Sanitize filename
-                filename = ActiveStorage::Filename.new(filename).sanitized
+                  # Sanitize filename
+                  filename = ActiveStorage::Filename.new(filename).sanitized
 
-                # Create or update attachment only if both filename and content are passed (this means that user uploaded a new file)
-                if !filename.blank? && !content.blank?
+                  # Create or update attachment only if both filename and content are passed (this means that user uploaded a new file)
+                  if !filename.blank? && !content.blank?
 
-                  # Delete the existing attachment
-                  if value.id && current_ids.include?(value.id)
-                    attachment_record = self.send("#{underlying_attachments}_attachments").find(value.id)
-                    attachment_record.purge_later
+                    # Delete the existing attachment
+                    if value.id && current_ids.include?(value.id)
+                      attachment_record = self.send("#{underlying_attachments}_attachments").find(value.id)
+                      attachment_record.purge_later
+                    end
+
+                    # Create a new attachment
+                    self.send(underlying_attachments).attach(io: StringIO.new(Base64.decode64(content)), filename: filename)
                   end
 
-                  # Create a new attachment
-                  self.send(underlying_attachments).attach(io: StringIO.new(Base64.decode64(content)), filename: filename)
                 end
 
-              end
-
-              # Delete no longer wanted attachments
-              current_values.each do |value|
-                unless new_ids.include?(value.id)
-                  attachment_record = self.send("#{underlying_attachments}_attachments").find(value.id)
-                  attachment_record.purge_later
+                # Delete no longer wanted attachments
+                current_values.each do |value|
+                  unless new_ids.include?(value.id)
+                    attachment_record = self.send("#{underlying_attachments}_attachments").find(value.id)
+                    attachment_record.purge_later
+                  end
                 end
               end
+
             end
 
             # Get method
@@ -111,6 +158,32 @@ module Eluvia
         end
 
       end
+
+      private
+
+      # Attaches each `{filename, content}` upload of an append-only file array attribute
+      def append_file_array_uploads(attr_name, underlying_attachments, new_values)
+        return if new_values.nil?
+
+        # Check input
+        raise Eluvia::Errors::BadRequest.new("Invalid value for attribute `#{attr_name}`, expecting Array.") unless new_values.is_a?(::Array)
+
+        new_values.each do |value|
+          # Normalize and check value
+          value = Eluvia::File.map(value) if value.is_a?(::Hash)
+          raise Eluvia::Errors::BadRequest.new("Invalid value for attribute `#{attr_name}[]`, expecting Eluvia::File.") unless value.is_a?(Eluvia::File)
+          raise Eluvia::Errors::BadRequest.new("Invalid value for attribute `#{attr_name}[]`, `upload_key` is not supported.") if value.upload_key.present?
+
+          # An item without content carries no new file
+          next if value.content.blank?
+
+          filename = ActiveStorage::Filename.new(value.filename.to_s).sanitized
+          raise Eluvia::Errors::BadRequest.new("Invalid value for attribute `#{attr_name}[].filename`, can't be blank.") if filename.blank?
+
+          self.send(underlying_attachments).attach(io: StringIO.new(Base64.decode64(value.content)), filename: filename)
+        end
+      end
+
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eluvia-base
 version: !ruby/object:Gem::Version
-  version: 3.40.0
+  version: 3.41.0
 platform: ruby
 authors:
 - Matěj Outlý
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-09-23 00:00:00.000000000 Z
+date: 2026-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client