habarico 7.3.0.pre.beta.11 → 7.3.0.pre.beta.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6c0c12a78eabc5ec2b734b49fe2631728bebfaaf0dccab0af628c195dc333880
-  data.tar.gz: 5bd53485346b0d43bef3791d74c69603a5b6ae8f005fed3eebacabeb4479affa
+  metadata.gz: d23f057b4303faf11bdd33bd6bcc7d0584afd1da5b4b732c3783480062445eb9
+  data.tar.gz: 18715b9bc472670e094686c12fff65200a4dfdf9ff0a1bbadb24a43c8a92de71
 SHA512:
-  metadata.gz: 554f357c1b5c47e163d4cbbb9fc441a921a116a05d360e3a01351f8cd120df1135603d512b31c92dd745ecb704347f478b4093b1d657568559407c50d8e66d5e
-  data.tar.gz: f1276d2569f91a2365dcdbf07d0c66d1eee8d24cdf39e9d34212b685f788baba7c70686aec9eca61ce0f508edc1ff870819ab5ff63ae2b6483dd729a421071d0
+  metadata.gz: 42ceff926802b0d9fc94beb97ddf28a72dceea6c55ec8cefd60c0a538f126ea7c21dc426758bfba02002314644c05347d851bb7e2c27bd7702dc7f9d7707140f
+  data.tar.gz: 66fcb4c6b8ac4446a7d376656de02b1ba2ecc99c568ffbdb27db96ccdeed9b297498f738f5ecf1bcd9488db0036c1da2a315324c34279697c4091127b5335da5

data/VERSION

@@ -1 +1 @@
-7.3.0-beta.11
+7.3.0-beta.13

data/lib/habarico/generators/endpoint/field_options_generator.rb

@@ -94,7 +94,7 @@ module Habarico
       nil # not possible to generate dynamic render without FieldReference
     end
 
-    # Largest file (bytes) this `file_attr` accepts, derived from its own
+    # Largest file (bytes) this file field accepts, derived from its own
     # `active_storage_validations` size declaration (HAB-966). `habarico_enterprise.uploads`, when
     # installed, additionally folds in the project-wide upload size ceiling for a field a
     # chunked-upload provider serves - see `Habarico::FileRulesResolver`.
@@ -105,7 +105,7 @@ module Habarico
       file_rules(model, attr_name).max_size
     end
 
-    # File types this `file_attr` accepts, derived from its own `active_storage_validations`
+    # File types this file field accepts, derived from its own `active_storage_validations`
     # content-type declaration (HAB-966).
     def generate_accept_at(model, attr_name)
       file_rules(model, attr_name).accept

data/lib/habarico/generators/endpoint/field_schema_generator.rb

@@ -46,7 +46,7 @@ module Habarico
         sort_by: generate_sort_by(model, field_name, attr_name, variant),
         reference: Habarico::ResourceReference.build(generate_reference(model, field_name, attr_name, variant)),
         enum: generate_enum(model, field_name, attr_name, variant),
-        items: generate_items(model, field_name, attr_name, variant, subfields),
+        items: generate_items(model, field_name, attr_name, variant, subfields, field_reference: field_reference),
         properties: generate_properties(model, field_name, attr_name, variant, subfields),
         options: generate_options(model, field_name, attr_name, variant),
       )
@@ -301,10 +301,22 @@ module Habarico
       nil
     end
 
-    def generate_items(model, field_name, attr_name, _variant, subfields)
+    def generate_items(model, field_name, attr_name, _variant, subfields, field_reference: nil)
       name = ''
       label = generate_label(model, field_name, attr_name, nil)
 
+      # "Append only" file array attribute is a list of uploads, each item a file the frontend uploads
+      if Habarico::ReflectionHelper.is_append_only_file_array_attr?(model, attr_name)
+        return Habarico::FieldSchema.new(
+          name: name,
+          label: label,
+          type: 'object',
+          format: model.find_file_array_attr(attr_name).fetch(:nature) == :image ? 'base64-image' : 'base64-file',
+          properties: fields_schema_generator.generate(Eluvia::File, %i[type url filename size content]),
+          options: field_options_generator.generate(model, attr_name, field_reference),
+        )
+      end
+
       # Manually declared "has many" reference is interpreted as array of relations, so we need to define items schema
       if Habarico::ReflectionHelper.is_has_many_reference?(model, field_name)
         reference = model.find_reference(field_name)
@@ -374,6 +386,9 @@ module Habarico
     end
 
     def generate_options(model, _field_name, attr_name, _variant)
+      # The upload options of an append-only file array are on its items, where the frontend reads them
+      return nil if Habarico::ReflectionHelper.is_append_only_file_array_attr?(model, attr_name)
+
       field_options_generator.generate(model, attr_name, nil)
     end
 

data/lib/habarico/helpers/reflection_helper.rb

@@ -21,6 +21,11 @@ module Habarico
       model_class.respond_to?(:has_reference?) && model_class.has_reference?(field_name, type: :has_many)
     end
 
+    def self.is_append_only_file_array_attr?(model_class, field_name)
+      model_class.respond_to?(:has_file_array_attr?) && model_class.has_file_array_attr?(field_name) &&
+        model_class.find_file_array_attr(field_name).fetch(:append_only)
+    end
+
     # *************************************************************************
     # Active model reflection methods
     # *************************************************************************

data/lib/habarico/resolvers/file_rules_resolver.rb

@@ -1,7 +1,7 @@
 require 'marcel'
 
 module Habarico
-  # The file rules of one `file_attr`: the allowed content types and the largest size its
+  # The file rules of one `file_attr` or `file_array_attr`: the allowed content types and the largest size its
   # `active_storage_validations` declarations admit - the rules a value is measured against, never
   # a value's own claimed properties. `allowed_content_types` is nil when the field declares no
   # content-type restriction; `max_size` is nil when it declares no upper bound.
@@ -22,12 +22,13 @@ module Habarico
     end
   end
 
-  # No declarations at all - what an unknown model, a non-`file_attr` attribute, or a host
-  # without `active_storage_validations` resolves to.
+  # No declarations at all - what an unknown model, an attribute that is not a file field, or a
+  # host without `active_storage_validations` resolves to.
   FileRules::NONE = FileRules.new(allowed_content_types: nil, max_size: nil).freeze
 
-  # Resolves the `FileRules` of a model's `file_attr` from the host's `active_storage_validations`
-  # declarations on its `underlying_attachment`. Mirrors the Python package's
+  # Resolves the `FileRules` of a model's `file_attr` or `file_array_attr` from the host's
+  # `active_storage_validations` declarations on its `underlying_attachment` /
+  # `underlying_attachments`. Mirrors the Python package's
   # `habarico.validators.content_types` / `habarico.validators.files`.
   #
   # `active_storage_validations` is deliberately NOT a dependency of this gem: a host that does not
@@ -38,22 +39,41 @@ module Habarico
     end
 
     # The `FileRules` of `attr_name`; `FileRules::NONE` when there is nothing to derive: no model,
-    # the attribute is not a `file_attr` or has no `underlying_attachment`, or
-    # `active_storage_validations` is not installed.
+    # the attribute is neither file field or has no underlying attachment, or
+    # `active_storage_validations` is not installed. An image `file_array_attr` keeps only the
+    # image types of its attachment's declaration, which may be shared with a file array filtered
+    # to the other types.
     def resolve(attr_name)
       return FileRules::NONE if @model.nil? || attr_name.blank?
-      return FileRules::NONE unless @model.respond_to?(:has_file_attr?) && @model.has_file_attr?(attr_name)
       return FileRules::NONE unless @model.respond_to?(:validators_on)
 
-      attachment = @model.find_file_attr(attr_name)&.fetch(:underlying_attachment, nil)
+      attachment, images_only = underlying_attachment(attr_name)
       return FileRules::NONE if attachment.blank?
 
       validators = @model.validators_on(attachment)
-      FileRules.new(allowed_content_types: content_types_from(validators), max_size: max_size_from(validators))
+      content_types = content_types_from(validators)
+      content_types = image_content_types(content_types) if images_only
+      FileRules.new(allowed_content_types: content_types, max_size: max_size_from(validators))
     end
 
     private
 
+    # The attachment name behind a file attribute, and whether only its image types apply.
+    def underlying_attachment(attr_name)
+      if @model.respond_to?(:has_file_attr?) && @model.has_file_attr?(attr_name)
+        [@model.find_file_attr(attr_name)&.fetch(:underlying_attachment, nil), false]
+      elsif @model.respond_to?(:has_file_array_attr?) && @model.has_file_array_attr?(attr_name)
+        spec = @model.find_file_array_attr(attr_name)
+        [spec[:underlying_attachments], spec[:nature] == :image]
+      end
+    end
+
+    def image_content_types(content_types)
+      return nil if content_types.nil?
+
+      content_types.select { |type| type.is_a?(::Regexp) || type.to_s.start_with?('image/') }.presence
+    end
+
     # The allowed content types of an `ActiveStorageValidations::ContentTypeValidator`, normalized
     # through Marcel exactly as the validator itself does at save time (`:png` and `'png'` both
     # become `'image/png'`), or nil when the field declares none.

data/lib/habarico/resolvers/record_params_resolver.rb

@@ -9,7 +9,7 @@ module Habarico
     # `params` narrowed to the resource's `fields` and `write_only_fields`.
     def resolve(params)
       write_fields = (@definition.fields + @definition.write_only_fields).uniq
-      params.permit(*write_fields.map { |field| permit_spec(field) })
+      params.permit(*write_fields.map { |field| permit_spec(field) }.uniq)
     end
 
     # A 422 with each error of `record` under every name its attribute is written by (an amount as
@@ -26,16 +26,22 @@ module Habarico
     private
 
     def permit_spec(field)
+      # Normalize Symbol/String/Hash/FieldReference entries so `permit` never receives a FieldReference.
+      name = Habarico::AttributesHelper.field_name(field)
+      model = @definition.model
+
+      # An append-only `file_array_attr` takes a list of base64 `{filename:, content:}` uploads,
+      # whatever subfields its declaration lists for reading.
+      return { name => %i[filename content] } if Habarico::ReflectionHelper.is_append_only_file_array_attr?(model, name)
+
       # Hash entries (`{ name => subfields }`) are already a nested permit spec - keep intact.
       return field if field.is_a?(::Hash)
 
-      # Normalize Symbol/String/FieldReference entries so `permit` never receives a FieldReference.
-      name = Habarico::AttributesHelper.field_name(field)
       # `ActionController::Parameters#permit` only allows scalar values for a bare field name -
       # a Hash value (e.g. a `file_attr` field's base64 `{filename:, content:}` or chunked-upload
       # `{upload_key:}` payload) is silently dropped unless its nested keys are explicitly
       # permitted. Expand file_attr fields into a nested permit spec; leave every other field as-is.
-      if @definition.model.respond_to?(:has_file_attr?) && @definition.model.has_file_attr?(name)
+      if model.respond_to?(:has_file_attr?) && model.has_file_attr?(name)
         { name => %i[filename content upload_key] }
       else
         name

data/lib/habarico/schema/endpoint/field_options.rb

@@ -42,13 +42,13 @@ module Habarico
     has_one_attr :ai, 'Habarico::AiFieldOptions'
 
     # Largest file (bytes) the frontend accepts for this field, checked before the upload starts.
-    # Derived from a `file_attr`'s own `active_storage_validations` size declaration (HAB-966); see
+    # Derived from a file field's own `active_storage_validations` size declaration (HAB-966); see
     # `Habarico::FileRulesResolver`. `habarico_enterprise.uploads` additionally folds in its
     # project-wide `Config.max_upload_size` ceiling for a field a chunked-upload provider serves.
     integer_attr :max_size
 
     # File types the frontend accepts for this field, checked before the upload starts. Derived
-    # from a `file_attr`'s own `active_storage_validations` content-type declaration (HAB-966); see
+    # from a file field's own `active_storage_validations` content-type declaration (HAB-966); see
     # `Habarico::FileRulesResolver`.
     has_many_attr :accept, 'String'
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: habarico
 version: !ruby/object:Gem::Version
-  version: 7.3.0.pre.beta.11
+  version: 7.3.0.pre.beta.13
 platform: ruby
 authors:
 - Matěj Outlý
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-30 00:00:00.000000000 Z
+date: 2026-11-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails