active_storage_validations 4.0.0 → 4.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 21b87628a4e532d945c76ceca7d37444c7524f15ed11b587a4bab0a5eae7eaef
-  data.tar.gz: 90fd47c4a439b00503e8997de2e344ace1771d15206a1e147fb785b94280abd4
+  metadata.gz: 24d8643d1f970252124d4429ca9bc15b222ef203cdcae93427a0860c7190c370
+  data.tar.gz: 62a74e517b40b32dba39c0529f0d4e4529d615a11decdebf8ec338505c082435
 SHA512:
-  metadata.gz: b851e77dcdd882cb2bcae49dc3871c5d5d5920409cb94bba357a77ecd55ff34efd0266fe52bb0866bf31db52eb324bc0ef80749d2805dd27b97d7c89a2adcb51
-  data.tar.gz: 422c62e2832c2adf34686832ec76ecc570f093133110838234c854c2ede5485324ebf9865aeb911f590a9c003485fd2d6535cced5e74d6ec686a562157ce983a
+  metadata.gz: c8fa701638b13eea05351e5a76847d144e93ec83b4e14a8d5b5e23ae71944eabd092704c723fcb81e9c44a3fb909ab6431be680390ee414f13002af671792ca1
+  data.tar.gz: 82af6984104d830cd7eda7ffdb557f3bb997d8bb59fbef6edc85e0830c3a4397209d4ab31f6427f5945fe392935fefe7c49dc6cabd87c840a34592e8b827f300

data/README.md

@@ -31,6 +31,7 @@ This gem is doing it right for you! Just use `validates :avatar, attached: true,
   - [Total size](#total-size)
   - [Dimension](#dimension)
   - [Duration](#duration)
+  - [With audio](#with-audio)
   - [Aspect ratio](#aspect-ratio)
   - [Processable file](#processable-file)
   - [Pages](#pages)
@@ -76,7 +77,7 @@ We recommend **libvips** (`ruby-vips` + `config.active_storage.variant_processor
 
 ### Using video and audio metadata validators
 
-To use the video and audio metadata validators (`dimension`, `aspect_ratio`, `processable_file` and `duration`), you will not need to add any gems. However you will need to have the `ffmpeg` command-line tool installed on your system (once again, be sure to have it installed both on your local and in your CI / production environments).
+To use the video and audio metadata validators (`dimension`, `aspect_ratio`, `processable_file`, `duration` and `with_audio`), you will not need to add any gems. However you will need to have the `ffmpeg` command-line tool installed on your system (once again, be sure to have it installed both on your local and in your CI / production environments).
 
 ### Using pdf metadata validators
 
@@ -115,7 +116,7 @@ end
 # end
 ```
 
-`command_timeout` bounds metadata analysis used by `dimension`, `aspect_ratio`, `duration`, `pages`, `processable_file`, and `content_type` (with `spoofing_protection`). When a command times out, analysis fails closed and the validator adds its usual error (`file_not_processable` / `media_metadata_missing` / content-type errors) — there is no separate timeout error message.
+`command_timeout` bounds metadata analysis used by `dimension`, `aspect_ratio`, `duration`, `with_audio`, `pages`, `processable_file`, and `content_type` (with `spoofing_protection`). When a command times out, analysis fails closed and the validator adds its usual error (`file_not_processable` / `media_metadata_missing` / `audio_missing` / content-type errors) — there is no separate timeout error message.
 
 The 10s default is enough for typical uploads. Raise it (or set `nil`) if you analyze very large videos/PDFs, especially on slow or network storage — otherwise those files can start failing validation after upgrade. See [upgrade to 4.x](docs/upgrade_to_4.md#analyzer-command-timeout).
 
@@ -140,6 +141,7 @@ Notes:
 - [Total size](#total-size): validates total file size for several files
 - [Dimension](#dimension): validates image / video dimensions
 - [Duration](#duration): validates video / audio duration
+- [With audio](#with-audio): validates whether a video contains an audio track
 - [Aspect ratio](#aspect-ratio): validates image / video aspect ratio
 - [Processable file](#processable-file): validates if a file can be processed
 - [Pages](#pages): validates pdf number of pages
@@ -644,6 +646,47 @@ The `duration` validator error messages expose 4 values that you can use:
 
 ---
 
+### With audio
+
+Validates whether attached video files contain an audio track.
+(be sure to have the right dependencies installed as mentioned in [Using video and audio metadata validators](#using-video-and-audio-metadata-validators))
+
+#### Options
+
+The `with_audio` validator supports:
+- `with`: `true` requires an audio track and `false` rejects one
+- `timeout`: overrides the global analyzer [command timeout](#configuration) for this validation
+
+#### Examples
+
+Use it like this:
+```ruby
+class User < ApplicationRecord
+  has_one_attached :video
+  has_one_attached :silent_video
+
+  validates :video, with_audio: true
+  validates :silent_video, with_audio: { with: false }
+  validates :video, with_audio: { timeout: 5.seconds }
+end
+```
+
+Rails treats a bare `with_audio: false` as a disabled validator. Use the hash form `with_audio: { with: false }` to reject videos that contain audio.
+
+#### Error messages (I18n)
+
+```yml
+en:
+  errors:
+    messages:
+      audio_missing: "must have an audio track"
+      audio_present: "must not have an audio track"
+```
+
+The `with_audio` validator error message exposes the `filename` value containing the current file name.
+
+---
+
 ### Aspect ratio
 
 Validates the aspect ratio of the attached image / video files.
@@ -895,6 +938,10 @@ describe User do
   it { is_expected.to validate_duration_of(:introduction).between(100..500.seconds) }
   it { is_expected.to validate_duration_of(:avatar).equal_to(5.minutes) }
 
+  # with_audio
+  it { is_expected.to validate_with_audio_of(:video) }
+  it { is_expected.to validate_with_audio_of(:silent_video).without_audio }
+
   # pages:
   # #less_than, #less_than_or_equal_to, #greater_than, #greater_than_or_equal_to, #between, #equal_to
   it { is_expected.to validate_pages_of(:contract).less_than(50) }
@@ -927,6 +974,7 @@ describe User do
 
   # :timeout (analyzer command timeout — metadata validators + content_type with spoofing)
   it { is_expected.to validate_duration_of(:video).less_than(5.minutes).timeout(30.seconds) }
+  it { is_expected.to validate_with_audio_of(:video).timeout(5.seconds) }
   it { is_expected.to validate_processable_file_of(:avatar).timeout(5.seconds) }
 end
 ```

data/config/locales/da.yml

@@ -55,6 +55,8 @@ da:
       aspect_ratio_not_x_y: "skal være %{authorized_aspect_ratios} (nuværende fil er %{width}x%{height}px)"
       aspect_ratio_invalid: "har et ugyldigt aspektforhold (gyldige aspektforhold er %{authorized_aspect_ratios})"
       file_not_processable: "identificeres ikke som en gyldig mediefil"
+      audio_missing: "skal have et lydspor"
+      audio_present: "må ikke have et lydspor"
       pages_not_less_than: "sideantal skal være mindre end %{max} (aktuelt sideantal er %{pages})"
       pages_not_less_than_or_equal_to: "sideantal skal være mindre end eller lig med %{max} (aktuelt sideantal er %{pages})"
       pages_not_greater_than: "sideantal skal være større end %{min} (aktuelt sideantal er %{pages})"

data/config/locales/de.yml

@@ -55,6 +55,8 @@ de:
       aspect_ratio_not_x_y: "muss %{authorized_aspect_ratios} sein (aktuelle Datei ist %{width}x%{height}px)"
       aspect_ratio_invalid: "hat ein ungültiges Seitenverhältnis (gültige Seitenverhältnisse sind %{authorized_aspect_ratios})"
       file_not_processable: "wird nicht als gültige Mediendatei identifiziert"
+      audio_missing: "muss eine Audiospur enthalten"
+      audio_present: "darf keine Audiospur enthalten"
       pages_not_less_than: "Die Seitenanzahl muss kleiner als %{max} sein (die aktuelle Seitenanzahl beträgt %{pages})."
       pages_not_less_than_or_equal_to: "Die Seitenanzahl muss kleiner oder gleich %{max} sein (die aktuelle Seitenanzahl beträgt %{pages})."
       pages_not_greater_than: "Die Seitenanzahl muss größer als %{min} sein (die aktuelle Seitenanzahl beträgt %{pages})."

data/config/locales/en-GB.yml

@@ -55,6 +55,8 @@ en-GB:
       aspect_ratio_not_x_y: "must be %{authorized_aspect_ratios} (current file is %{width}x%{height}px)"
       aspect_ratio_invalid: "has an invalid aspect ratio (valid aspect ratios are %{authorized_aspect_ratios})"
       file_not_processable: "is not identified as a valid media file"
+      audio_missing: "must have an audio track"
+      audio_present: "must not have an audio track"
       pages_not_less_than: "page count must be less than %{max} (current page count is %{pages})"
       pages_not_less_than_or_equal_to: "page count must be less than or equal to %{max} (current page count is %{pages})"
       pages_not_greater_than: "page count must be greater than %{min} (current page count is %{pages})"

data/config/locales/en.yml

@@ -55,6 +55,8 @@ en:
       aspect_ratio_not_x_y: "must be %{authorized_aspect_ratios} (current file is %{width}x%{height}px)"
       aspect_ratio_invalid: "has an invalid aspect ratio (valid aspect ratios are %{authorized_aspect_ratios})"
       file_not_processable: "is not identified as a valid media file"
+      audio_missing: "must have an audio track"
+      audio_present: "must not have an audio track"
       pages_not_less_than: "page count must be less than %{max} (current page count is %{pages})"
       pages_not_less_than_or_equal_to: "page count must be less than or equal to %{max} (current page count is %{pages})"
       pages_not_greater_than: "page count must be greater than %{min} (current page count is %{pages})"

data/config/locales/es.yml

@@ -55,6 +55,8 @@ es:
       aspect_ratio_not_x_y: "debe ser %{authorized_aspect_ratios} (el archivo actual es %{width}x%{height}px)"
       aspect_ratio_invalid: "tiene una relación de aspecto inválida (las relaciones de aspecto válidas son %{authorized_aspect_ratios})"
       file_not_processable: "no se identifica como un archivo multimedia válido"
+      audio_missing: "debe tener una pista de audio"
+      audio_present: "no debe tener una pista de audio"
       pages_not_less_than: "el número de páginas debe ser menor que %{max} (el número actual de páginas es %{pages})"
       pages_not_less_than_or_equal_to: "el número de páginas debe ser menor o igual que %{max} (el número actual de páginas es %{pages})"
       pages_not_greater_than: "el número de páginas debe ser mayor que %{min} (el número actual de páginas es %{pages})"

data/config/locales/fr.yml

@@ -55,6 +55,8 @@ fr:
       aspect_ratio_not_x_y: "doit être %{authorized_aspect_ratios} (le fichier actuel est %{width}x%{height}px)"
       aspect_ratio_invalid: "a un rapport d'aspect invalide (les rapports d'aspect valides sont %{authorized_aspect_ratios})"
       file_not_processable: "n'est pas identifié comme un fichier média valide"
+      audio_missing: "doit contenir une piste audio"
+      audio_present: "ne doit pas contenir de piste audio"
       pages_not_less_than: "le nombre de pages doit être inférieur à %{max} (le nombre actuel est de %{pages})"
       pages_not_less_than_or_equal_to: "le nombre de pages doit être inférieur ou égal à %{max} (le nombre actuel est de %{pages})"
       pages_not_greater_than: "le nombre de pages doit être supérieur à %{min} (le nombre actuel est de %{pages})"

data/config/locales/it.yml

@@ -55,6 +55,8 @@ it:
       aspect_ratio_not_x_y: "deve essere %{authorized_aspect_ratios} (il file corrente è %{width}x%{height}px)"
       aspect_ratio_invalid: "ha un formato non valido (i rapporti di aspetto validi sono %{authorized_aspect_ratios})"
       file_not_processable: "non è identificato come file multimediale valido"
+      audio_missing: "deve contenere una traccia audio"
+      audio_present: "non deve contenere una traccia audio"
       pages_not_less_than: "il numero di pagine deve essere inferiore a %{max} (il numero di pagine corrente è %{pages})"
       pages_not_less_than_or_equal_to: "il numero di pagine deve essere inferiore o uguale a %{max} (il numero di pagine corrente è %{pages})"
       pages_not_greater_than: "il numero di pagine deve essere maggiore di %{min} (il numero di pagine corrente è %{pages})"

data/config/locales/ja.yml

@@ -55,6 +55,8 @@ ja:
       aspect_ratio_not_x_y: "のアスペクト比は%{authorized_aspect_ratios}にしてください (添付されたメディアの解像度は%{width}x%{height})"
       aspect_ratio_invalid: "のアスペクト比を検出できません (許可されたアスペクト比は%{authorized_aspect_ratios})"
       file_not_processable: "のメディアを処理できません"
+      audio_missing: "には音声トラックが必要です"
+      audio_present: "に音声トラックを含めることはできません"
       pages_not_less_than: "のページ数は%{max}未満にしてください (添付されたファイルは%{pages}ページ)"
       pages_not_less_than_or_equal_to: "のページ数は%{max}以下にしてください (添付されたファイルは%{pages}ページ)"
       pages_not_greater_than: "のページ数は%{min}より大きくしてください (添付されたファイルは%{pages}ページ)"

data/config/locales/nl.yml

@@ -55,6 +55,8 @@ nl:
       aspect_ratio_not_x_y: "moet %{authorized_aspect_ratios} zijn (huidig bestand is %{width}x%{height}px)"
       aspect_ratio_invalid: "heeft een ongeldige beeldverhouding (geldige beeldverhoudingen zijn %{authorized_aspect_ratios})"
       file_not_processable: "wordt niet geïdentificeerd als een geldig mediabestand"
+      audio_missing: "moet een audiotrack bevatten"
+      audio_present: "mag geen audiotrack bevatten"
       pages_not_less_than: "het aantal pagina's moet kleiner zijn dan %{max} (het huidige aantal pagina's is %{pages})"
       pages_not_less_than_or_equal_to: "het aantal pagina's moet kleiner zijn dan of gelijk zijn aan %{max} (het huidige aantal pagina's is %{pages})"
       pages_not_greater_than: "het aantal pagina's moet groter zijn dan %{min} (het huidige aantal pagina's is %{pages})"

data/config/locales/pl.yml

@@ -55,6 +55,8 @@ pl:
       aspect_ratio_not_x_y: "musi być %{authorized_aspect_ratios} (bieżący plik to %{width}x%{height}px)"
       aspect_ratio_invalid: "ma nieprawidłowy współczynnik kształtu (ważne współczynniki kształtu wynoszą %{authorized_aspect_ratios})"
       file_not_processable: "nie jest identyfikowany jako prawidłowy plik multimedialny"
+      audio_missing: "musi zawierać ścieżkę dźwiękową"
+      audio_present: "nie może zawierać ścieżki dźwiękowej"
       pages_not_less_than: "liczba stron musi być mniejsza niż %{max} (bieżąca liczba stron to %{pages})"
       pages_not_less_than_or_equal_to: "liczba stron musi być mniejsza lub równa %{max} (bieżąca liczba stron to %{pages})"
       pages_not_greater_than: "liczba stron musi być większa niż %{min} (bieżąca liczba stron to %{pages})"

data/config/locales/pt-BR.yml

@@ -55,6 +55,8 @@ pt-BR:
       aspect_ratio_not_x_y: "deve ser %{authorized_aspect_ratios} (o arquivo atual é %{width}x%{height}px)"
       aspect_ratio_invalid: "tem uma proporção inválida (as proporções válidas são %{authorized_aspect_ratios})"
       file_not_processable: "não é identificado como um arquivo de mídia válido"
+      audio_missing: "deve ter uma faixa de áudio"
+      audio_present: "não deve ter uma faixa de áudio"
       pages_not_less_than: "a contagem de páginas deve ser menor que %{max} (a contagem atual de páginas é %{pages})"
       pages_not_less_than_or_equal_to: "a contagem de páginas deve ser menor ou igual a %{max} (a contagem atual de páginas é %{pages})"
       pages_not_greater_than: "a contagem de páginas deve ser maior que %{min} (a contagem atual de páginas é %{pages})"

data/config/locales/ru.yml

@@ -55,6 +55,8 @@ ru:
       aspect_ratio_not_x_y: "должно быть %{authorized_aspect_ratios} (текущий файл %{width}x%{height} пикселей)"
       aspect_ratio_invalid: "имеет недействительное соотношение сторон (действительные соотношения сторон %{authorized_aspect_ratios})"
       file_not_processable: "не идентифицируется как действительный медиафайл"
+      audio_missing: "должен содержать аудиодорожку"
+      audio_present: "не должен содержать аудиодорожку"
       pages_not_less_than: "количество страниц должно быть меньше %{max} (текущее количество страниц %{pages})"
       pages_not_less_than_or_equal_to: "количество страниц должно быть меньше или равно %{max} (текущее количество страниц %{pages})"
       pages_not_greater_than: "количество страниц должно быть больше %{min} (текущее количество страниц %{pages})"

data/config/locales/sv.yml

@@ -55,6 +55,8 @@ sv:
       aspect_ratio_not_x_y: "måste vara% { authorized_aspect_ratios } (nuvarande fil är %{width}x%{height} pixlar)"
       aspect_ratio_invalid: "har ett ogiltigt bildförhållande (giltiga bildförhållanden är %{förväntat_aspect_ratios})"
       file_not_processable: "identifieras inte som en giltig mediefil"
+      audio_missing: "måste innehålla ett ljudspår"
+      audio_present: "får inte innehålla ett ljudspår"
       pages_not_less_than: "sidantal måste vara mindre än %{max} (nuvarande sidantal är %{pages})"
       pages_not_less_than_or_equal_to: "sidantal måste vara mindre än eller lika med %{max} (nuvarande antal sidor är %{pages})"
       pages_not_greater_than: "sidantal måste vara större än %{min} (nuvarande sidantal är %{pages})"

data/config/locales/tr.yml

@@ -55,6 +55,8 @@ tr:
       aspect_ratio_not_x_y: "%{authorized_aspect_ratios} olmalıdır (geçerli dosya %{width}x%{height}px)"
       aspect_ratio_invalid: "geçersiz bir en boy oranına sahiptir (geçerli en boy oranları %{authorized_aspect_ratios})"
       file_not_processable: "geçerli bir medya dosyası olarak tanımlanmadı"
+      audio_missing: "bir ses parçası içermelidir"
+      audio_present: "bir ses parçası içermemelidir"
       pages_not_less_than: "sayfa sayısı %{max} değerinden az olmalıdır (geçerli sayfa sayısı %{pages})"
       pages_not_less_than_or_equal_to: "sayfa sayısı %{max} değerinden az veya eşit olmalıdır (geçerli sayfa sayısı %{pages})"
       pages_not_greater_than: "sayfa sayısı %{min} değerinden fazla olmalıdır (geçerli sayfa sayısı %{pages})"

data/config/locales/uk.yml

@@ -55,6 +55,8 @@ uk:
       aspect_ratio_not_x_y: "повинен бути %{authorized_aspect_ratios} (поточний файл становить %{width}x%{height} пікселям)"
       aspect_ratio_invalid: "має недійсне співвідношення сторін (дійсні співвідношення сторін %{authorized_aspect_ratios})"
       file_not_processable: "не ідентифікується як дійсний медіа-файл"
+      audio_missing: "має містити аудіодоріжку"
+      audio_present: "не має містити аудіодоріжку"
       pages_not_less_than: "кількість сторінок має бути менше %{max} (поточна кількість сторінок %{pages})"
       pages_not_less_than_or_equal_to: "кількість сторінок має бути меншою або дорівнювати %{max} (поточна кількість сторінок становить %{pages})"
       pages_not_greater_than: "кількість сторінок має бути більшою за %{min} (поточна кількість сторінок становить %{pages})"

data/config/locales/vi.yml

@@ -55,6 +55,8 @@ vi:
       aspect_ratio_not_x_y: "phải là %{authorized_aspect_ratios} (tệp hiện tại là %{width}x%{height}px)"
       aspect_ratio_invalid: "có tỷ lệ khung hình không hợp lệ (tỷ lệ khung hình hợp lệ là %{authorized_aspect_ratios})"
       file_not_processable: "không được xác định là tệp phương tiện hợp lệ"
+      audio_missing: "phải có một bản âm thanh"
+      audio_present: "không được chứa bản âm thanh"
       pages_not_less_than: "số trang phải nhỏ hơn %{max} (số trang hiện tại là %{pages})"
       pages_not_less_than_or_equal_to: "số trang phải nhỏ hơn hoặc bằng %{max} (số trang hiện tại là %{pages})"
       pages_not_greater_than: "số trang phải lớn hơn %{min} (số trang hiện tại là %{pages})"

data/config/locales/zh-CN.yml

@@ -55,6 +55,8 @@ zh-CN:
       aspect_ratio_not_x_y: "必须为 %{authorized_aspect_ratios}（当前文件为 %{width} x%{height} 像素)"
       aspect_ratio_invalid: "具有无效的长宽比（有效长宽比为 %{authorized_aspect_ratios})"
       file_not_processable: "未标识为有效的媒体文件"
+      audio_missing: "必须包含音轨"
+      audio_present: "不得包含音轨"
       pages_not_less_than: "页数必须小于 %{max}（当前页数为 %{pages})"
       pages_not_less_than_or_equal_to: "页数必须小于或等于 %{max}（当前页数为 %{pages})"
       pages_not_greater_than: "页数必须大于 %{min}（当前页数为 %{pages})"

data/lib/active_storage_validations/matchers/with_audio_validator_matcher.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+require_relative "shared/asv_active_storageable"
+require_relative "shared/asv_allow_blankable"
+require_relative "shared/asv_attachable"
+require_relative "shared/asv_contextable"
+require_relative "shared/asv_except_onable"
+require_relative "shared/asv_messageable"
+require_relative "shared/asv_rspecable"
+require_relative "shared/asv_timeoutable"
+require_relative "shared/asv_validatable"
+
+module ActiveStorageValidations
+  module Matchers
+    def validate_with_audio_of(attribute_name)
+      WithAudioValidatorMatcher.new(attribute_name)
+    end
+
+    class WithAudioValidatorMatcher
+      include ASVActiveStorageable
+      include ASVAllowBlankable
+      include ASVAttachable
+      include ASVContextable
+      include ASVExceptOnable
+      include ASVMessageable
+      include ASVRspecable
+      include ASVTimeoutable
+      include ASVValidatable
+
+      def initialize(attribute_name)
+        initialize_allow_blankable
+        initialize_contextable
+        initialize_except_onable
+        initialize_messageable
+        initialize_rspecable
+        initialize_timeoutable
+        @attribute_name = attribute_name
+        @expected_audio = true
+      end
+
+      def description
+        "validate that :#{@attribute_name} #{audio_expectation}"
+      end
+
+      def failure_message
+        "is expected to validate that :#{@attribute_name} #{audio_expectation}"
+      end
+
+      def without_audio
+        @expected_audio = false
+        self
+      end
+
+      def matches?(subject)
+        @subject = subject.is_a?(Class) ? subject.new : subject
+
+        is_a_valid_active_storage_attribute? &&
+          is_context_valid? &&
+          is_except_on_valid? &&
+          is_allowing_blank? &&
+          is_timeout_valid? &&
+          is_custom_message_valid? &&
+          is_valid_with_expected_audio? &&
+          is_invalid_with_unexpected_audio?
+      end
+
+      private
+
+      def audio_expectation
+        @expected_audio ? "has an audio track" : "has no audio track"
+      end
+
+      def is_valid_with_expected_audio?
+        validation_passes_with_audio?(@expected_audio)
+      end
+
+      def is_invalid_with_unexpected_audio?
+        !validation_passes_with_audio?(!@expected_audio)
+      end
+
+      def is_custom_message_valid?
+        return true unless @custom_message
+
+        with_audio_metadata(false) do
+          attach_file(video_file)
+          validate
+          detach_file
+          has_an_error_message_which_is_custom_message?
+        end
+      end
+
+      def validation_passes_with_audio?(audio)
+        with_audio_metadata(audio) do
+          attach_file(video_file)
+          validate
+          detach_file
+          is_valid?
+        end
+      end
+
+      def with_audio_metadata(audio, &block)
+        Matchers.mock_metadata(io, { audio: audio }, &block)
+      end
+
+      def video_file
+        {
+          io: io,
+          filename: "test.mp4",
+          content_type: "video/mp4"
+        }
+      end
+    end
+  end
+end

data/lib/active_storage_validations/matchers.rb

@@ -7,6 +7,7 @@ require "active_storage_validations/matchers/limit_validator_matcher"
 require "active_storage_validations/matchers/content_type_validator_matcher"
 require "active_storage_validations/matchers/dimension_validator_matcher"
 require "active_storage_validations/matchers/duration_validator_matcher"
+require "active_storage_validations/matchers/with_audio_validator_matcher"
 require "active_storage_validations/matchers/size_validator_matcher"
 require "active_storage_validations/matchers/total_size_validator_matcher"
 require "active_storage_validations/matchers/pages_validator_matcher"

data/lib/active_storage_validations/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ActiveStorageValidations
-  VERSION = "4.0.0"
+  VERSION = "4.1.0"
 end

data/lib/active_storage_validations/with_audio_validator.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require_relative "shared/asv_active_storageable"
+require_relative "shared/asv_analyzable"
+require_relative "shared/asv_attachable"
+require_relative "shared/asv_errorable"
+require_relative "shared/asv_symbolizable"
+
+module ActiveStorageValidations
+  class WithAudioValidator < ActiveModel::EachValidator # :nodoc
+    include ASVActiveStorageable
+    include ASVAnalyzable
+    include ASVAttachable
+    include ASVErrorable
+    include ASVSymbolizable
+
+    ERROR_TYPES = %i[audio_missing audio_present].freeze
+    METADATA_KEYS = %i[audio].freeze
+
+    def validate_each(record, attribute, _value)
+      return if no_attachments?(record, attribute)
+
+      validate_changed_files_from_metadata(record, attribute, METADATA_KEYS)
+    end
+
+    private
+
+    def is_valid?(record, attribute, attachable, metadata)
+      expected_audio = options.fetch(:with, true)
+      return if metadata&.fetch(:audio, false) == expected_audio
+
+      errors_options = initialize_error_options(options, attachable)
+      error_type = expected_audio ? :audio_missing : :audio_present
+      add_error(record, attribute, error_type, **errors_options)
+    end
+  end
+end

data/lib/active_storage_validations.rb

@@ -41,6 +41,7 @@ require "active_storage_validations/content_type_validator"
 require "active_storage_validations/limit_validator"
 require "active_storage_validations/dimension_validator"
 require "active_storage_validations/duration_validator"
+require "active_storage_validations/with_audio_validator"
 require "active_storage_validations/aspect_ratio_validator"
 require "active_storage_validations/processable_file_validator"
 require "active_storage_validations/size_validator"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: active_storage_validations
 version: !ruby/object:Gem::Version
-  version: 4.0.0
+  version: 4.1.0
 platform: ruby
 authors:
 - Igor Kasyanchuk
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-02 00:00:00.000000000 Z
+date: 2026-08-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activejob
@@ -265,6 +265,7 @@ files:
 - lib/active_storage_validations/matchers/shared/asv_validatable.rb
 - lib/active_storage_validations/matchers/size_validator_matcher.rb
 - lib/active_storage_validations/matchers/total_size_validator_matcher.rb
+- lib/active_storage_validations/matchers/with_audio_validator_matcher.rb
 - lib/active_storage_validations/pages_validator.rb
 - lib/active_storage_validations/processable_file_validator.rb
 - lib/active_storage_validations/railtie.rb
@@ -279,6 +280,7 @@ files:
 - lib/active_storage_validations/size_validator.rb
 - lib/active_storage_validations/total_size_validator.rb
 - lib/active_storage_validations/version.rb
+- lib/active_storage_validations/with_audio_validator.rb
 homepage: https://github.com/igorkasyanchuk/active_storage_validations
 licenses:
 - MIT