forest_liana 9.20.7 → 9.20.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed69fd6aba8fea8a03a02738a6f9ca6e75ae334980e501470dbabe1d58c37497
-  data.tar.gz: a6439711199628972e57f782968244c096566919801510d2193e3d16fbe5d800
+  metadata.gz: dfcdfafce741a2f8305f64a7241219a6f9b54227dd310dd7269ff83043f0f35d
+  data.tar.gz: c3ce3c647b53d3cc7bd8c5d45ed98c887588112c6e5e7fc558ca6ca5ddf385f2
 SHA512:
-  metadata.gz: e6101bb2d0ea3dfe2b3944cdf5d2ca3391ecd26450653517dd30553ffd4075dcb0cb23b6659996303259f6bd931c8054a58986f9337adc5417f94df8f1aac8b2
-  data.tar.gz: 3de7e6bc1710e6e8f8e1c8b1857775091e7d5d707d57c9f7f4dd1a993c7fbac111e350a88d4623e90357b8815aaf74a1de6a01710c01a81bd039b465ca19f600
+  metadata.gz: debd8bdb65d707795b7e895769c3ec1bd1fc0796bc971edfad2d0446a6b19e1b2b78bdd1c64cd77b2dc615eecc5384b868d1e8ab01810646aa287fd8c7c1a1f1
+  data.tar.gz: 9534d5fd16d409d282dd806955386e730a428c3c8405b0beb0284bd317f6825a8f5cdf616ca662e4148a8df9703b23e0370772edd9a35d9c6dbca9e5fe72ff76

data/app/services/forest_liana/filters_parser.rb

@@ -83,6 +83,10 @@ module ForestLiana
       value = condition['value']
       field_name = condition['field']
 
+      # NOTICE: captured before the enum mapping below, which turns an unknown
+      #         enum value into nil and would otherwise look like a null filter.
+      null_value = value.nil?
+
       if @operator_date_parser.is_date_operator?(operator)
         field_schema = SchemaUtils.find_column_schema_by_name(ForestLiana.name_for(@resource), field_name)
         condition = @operator_date_parser.get_date_filter(operator, value, field_schema)
@@ -99,6 +103,14 @@ module ForestLiana
 
       case_insensitive = operator == 'i_contains'
       parsed_field = parse_field_name(field_name, case_insensitive)
+
+      # NOTICE: the UI sends a null equality filter as a JSON null; `= NULL` and
+      #         `!= NULL` never match anything in SQL.
+      if null_value
+        return "#{parsed_field} IS NULL" if operator == 'equal'
+        return "#{parsed_field} IS NOT NULL" if operator == 'not_equal'
+      end
+
       parsed_operator = parse_operator(operator)
       parsed_value = parse_value(operator, value)
       field_and_operator = "#{parsed_field} #{parsed_operator}"

data/lib/forest_liana/version.rb

@@ -1,3 +1,3 @@
 module ForestLiana
-  VERSION = "9.20.7"
+  VERSION = "9.20.8"
 end

data/spec/services/forest_liana/filters_parser_spec.rb

@@ -45,6 +45,29 @@ module ForestLiana
             it { expect(parsed_filters.count).to eq 1 }
           end
 
+          context 'equal on a null value (JSON null from the UI)' do
+            before do
+              Tree.create!(name: nil, age: 42, island: Island.first)
+              Tree.create!(name: 'null', age: 43, island: Island.first)
+            end
+
+            let(:filters) { { 'field' => 'name', 'operator' => 'equal', 'value' => nil } }
+
+            it 'matches rows where the column IS NULL, not the literal string "null"' do
+              expect(parsed_filters.pluck(:name)).to eq([nil])
+            end
+          end
+
+          context 'not_equal on a null value (JSON null from the UI)' do
+            before { Tree.create!(name: nil, age: 42, island: Island.first) }
+
+            let(:filters) { { 'field' => 'name', 'operator' => 'not_equal', 'value' => nil } }
+
+            it 'matches rows where the column IS NOT NULL' do
+              expect(parsed_filters.pluck(:name)).to match_array(['Tree n1', 'Tree n2', 'Tree n3'])
+            end
+          end
+
           context 'greater_than' do
             let(:filters) { { 'field' => 'age', 'operator' => 'greater_than', 'value' => 2 } }
             it { expect(parsed_filters.count).to eq 2 }
@@ -107,6 +130,14 @@ module ForestLiana
             it { expect(parsed_filters.count).to eq 0 }
           end
 
+          context 'equal on an unknown enum value' do
+            # The enum mapping nils an unknown value; the null-filter guard is
+            # keyed on the pre-mapping value so it must NOT become `IS NULL`
+            # (that would wrongly match rows whose joined cutter is absent).
+            let(:filters) { { 'field' => 'cutter:title', 'operator' => 'equal', 'value' => 'not_a_title' } }
+            it { expect(parsed_filters.count).to eq 0 }
+          end
+
           context 'contains' do
             let(:filters) { { 'field' => 'owner:title', 'operator' => 'contains', 'value' => 'in' } }
             it { expect(parsed_filters.count).to eq 3 }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: forest_liana
 version: !ruby/object:Gem::Version
-  version: 9.20.7
+  version: 9.20.8
 platform: ruby
 authors:
 - Sandro Munda
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-03 00:00:00.000000000 Z
+date: 2026-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails