exwiw 0.6.2 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2dc1d7b1052722433d6328889f3fba23233d09edfdf1db1d3c27d89598951cb1
-  data.tar.gz: 7e0cdbe59e89ea5fb7ced4dce6e170a0e88d09715789ca1faea4f36bc2558a66
+  metadata.gz: 12765a8f130dec0055149beb7ba69b37c9b548758cfbd8dd807c1499a9fbf0b5
+  data.tar.gz: 9165cda22d6e4eb2ff97a6d386510a04f37d353e2b31ea4b6bada2fc1ad2adb7
 SHA512:
-  metadata.gz: 5ab4c1f3c40d11c8d717d20639b3338c18df168880059c6c1e74d33e6f6bf9d9ce9f6921b9e8c613dc4aa24f8dfaf058017382763af45a888edc3c665e38373a
-  data.tar.gz: ebddd4d938ef4369e41a87e4b57cde92c0cf534920459eafc6df7e5d0eeec2fc37810effe0ba4656a14890d75c73e2cb3c0b9f9f9f38e5bf9807df2ec156585e
+  metadata.gz: eb9ad3e65e4b8756574b5c97fec28be38cc708604cbdaffcb772bd8958b183a067dffafa44078705ed00346be27a9aa81bd68a212b7bcecf635a84d6a7f86adc
+  data.tar.gz: fd47a8459abec5a56ab2c64c7cecc4ffa916608b2cf9278a68a2985defa18812b4f09b70a54b8d6ac498a305022644a0a0d923358a5a06143dedcb550aab7e84

data/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-06-23
+
+### Changed
+
+- **`replace_with` now preserves NULL.** A NULL source value stays NULL instead of being replaced by the masked literal (all adapters: MySQL, PostgreSQL, SQLite, MongoDB). Previously masking a nullable column clobbered NULL into a non-NULL value, losing the "not set" signal in the dump and making `.nil?`/`.present?`-dependent code behave differently than against production. The SQL adapters now wrap the masking expression in `CASE WHEN <column> IS NOT NULL THEN <masked> ELSE NULL END`, and the MongoDB adapter skips masking a field whose value is nil or absent. This is a behavior change for **nullable** masked columns only — `NOT NULL` columns are unaffected, and an empty string is a real value that is still masked (only true NULL/absent is preserved). It removes the need for hand-written `raw_sql` `CASE` workarounds to keep NULLs.
+
 ## [0.6.2] - 2026-06-21
 
 ## [0.6.1] - 2026-06-20

data/README.md

@@ -614,6 +614,12 @@ and you can use the column name with `{}` to replace the value with the column v
 For example, Let assume we have the record which id is 1,
 then "user{id}@example.com" will be replaced with "user1@example.com".
 
+`replace_with` **preserves NULL**: a source value that is `NULL` (or, for MongoDB, an
+absent field) is left as-is instead of being replaced by the masked literal, so the
+"not set" signal survives into the dump. Only true `NULL`/absent is preserved — an empty
+string is a real value and is still masked. Because of this you do not need to hand-write a
+`raw_sql` `CASE WHEN ... IS NOT NULL ...` to keep NULLs.
+
 #### `raw_sql`
 
 It will used instead of the original value.

data/lib/exwiw/adapter/mongodb_adapter.rb

@@ -514,6 +514,11 @@ module Exwiw
       # pair, with all per-config lookups hoisted into the plan.
       private def apply_mask_plan!(doc, plan)
         plan.masked_fields.each do |name, segments|
+          # Preserve a NULL / absent source value instead of clobbering it into a
+          # masked literal. `doc[name].nil?` is true for both an explicit nil and
+          # an absent key, so an absent key is left absent (not created).
+          next if doc[name].nil?
+
           doc[name] = render_template(segments, doc)
         end
         plan.embedded.each do |child|

data/lib/exwiw/adapter/mysql_adapter.rb

@@ -330,7 +330,7 @@ module Exwiw
           end
 
           replaced = parts.join(", ")
-          "CONCAT(#{replaced})"
+          null_preserving(ast, column, "CONCAT(#{replaced})")
         else
           raise "Unreachable case: #{column.inspect}"
         end

data/lib/exwiw/adapter/postgresql_adapter.rb

@@ -456,7 +456,7 @@ module Exwiw
           end
 
           replaced = parts.join(", ")
-          "CONCAT(#{replaced})"
+          null_preserving(ast, column, "CONCAT(#{replaced})")
         else
           raise "Unreachable case: #{column.inspect}"
         end

data/lib/exwiw/adapter/sqlite_adapter.rb

@@ -298,7 +298,7 @@ module Exwiw
           end
 
           replaced = parts.join(" || ")
-          "(#{replaced})"
+          null_preserving(ast, column, "(#{replaced})")
         else
           raise "Unreachable case: #{column.inspect}"
         end

data/lib/exwiw/adapter.rb

@@ -202,6 +202,17 @@ module Exwiw
       rescue => e
         "<unavailable: #{e.class}: #{e.message}>"
       end
+
+      # Wrap a masking expression so a NULL source value stays NULL instead of
+      # being clobbered into a non-NULL literal. The guard checks the masked
+      # column itself (`column.name`) — not any other column the template may
+      # reference — so only true NULL is preserved; an empty string is a real
+      # value and is still masked. The column reference uses the same
+      # `<from_table>.<col>` form as the Plain branch. Shared by the SQL
+      # adapters' #compile_column_name ReplaceWith handling.
+      private def null_preserving(ast, column, masked_expr)
+        "CASE WHEN #{ast.from_table_name}.#{column.name} IS NOT NULL THEN #{masked_expr} ELSE NULL END"
+      end
     end
 
     # @params [Exwiw::QueryAst] query_ast

data/lib/exwiw/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Exwiw
-  VERSION = "0.6.2"
+  VERSION = "0.7.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: exwiw
 version: !ruby/object:Gem::Version
-  version: 0.6.2
+  version: 0.7.0
 platform: ruby
 authors:
 - Shia