nxt_support 0.6.3 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: df7d032c4cf505b1381021fb5118f9f2c71aee05eb1bdb4484915dc1aa9f78a8
-  data.tar.gz: 2cdf4c3050bcd760bc5f17bae3f3e12e550b0726eb20047e3a485d7a26853b3e
+  metadata.gz: 7dd667ded531216f8bcfd88bdd112ee369bf1e5707b79263db64a76d6abfb15e
+  data.tar.gz: 91eba200463b8c381ee42eb40ce9e209e81d020d8027eaecb97e38ca03b8984b
 SHA512:
-  metadata.gz: 52dad4f65484fc4b61cf6d0bdda7dab60d3b095a208f2c194d83f8254ef4bc9f1e49aee538bc2a3ab2fe1551c08cbd37e4dc6fa81a2f0a451d9a21475b818d7d
-  data.tar.gz: 5baa5b0e528521f30a6cd0b92674ed535a3f3b2a6b3d63ef96b448390de87cfc2d7170deba87a3bf9c6d3a3ac28ce923eaaf03cfc1e1a12630b90e6a998fd8b0
+  metadata.gz: 49219628e5f0de43677bbbf04ac4518ec29226d0f4f9e86c164dddb72931d3349fd4f2a22400d3e976c595d94ee9568d26137dfdcb0b88ed6ccebbb4687cf284
+  data.tar.gz: a62a06f6809f429dd9bec2a88127c7709f78fe1b0dcd2a20d07efa34b0e129af91f70e7cd2788c45ae0554f10a99bd222b244a8b8d45d96758a3f40533042728

data/CHANGELOG.md

@@ -1,3 +1,6 @@
+# v0.7.0 2026-09-16
+- Added `NxtSupport::Iban`
+
 # v0.6.3 2026-08-11
 - Fix `Crystalizer#call` to return the resolved value from a custom `on_ambiguity` handler instead of always returning `unique_values.first`
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    nxt_support (0.6.3)
+    nxt_support (0.7.0)
       activerecord
       activesupport
       nxt_init

data/README.md

@@ -360,6 +360,33 @@ NxtSupport::BirthDate.new(date: '1990-08-08').to_age # => 30
 NxtSupport::BirthDate.new(date: '1990-08-08').to_age_in_months # => 361
 ```
 
+#### NxtSupport::Iban
+
+`NxtSupport::Iban` normalizes IBANs into the form payment providers and comparisons expect: upcased, with all
+whitespace removed. It does not validate the IBAN — anything that is not a string is returned unchanged.
+
+```ruby
+NxtSupport::Iban.normalize('de89 3704 0044 0532 0130 00') # => "DE89370400440532013000"
+NxtSupport::Iban.new(iban: 'de89 3704 0044 0532 0130 00').normalize # => "DE89370400440532013000"
+```
+
+`#to_s`, `#country_code` and `#last4` all read from the normalized form, so they give the same answer no matter how
+the IBAN was written. `#to_s` returns an empty string for a missing IBAN, while `#country_code` and `#last4` return
+`nil` rather than an empty string.
+
+```ruby
+iban = NxtSupport::Iban.new(iban: 'de89 3704 0044 0532 0130 00')
+
+iban.to_s          # => "DE89370400440532013000"
+iban.country_code  # => "DE"
+iban.last4         # => "3000"
+iban.redacted_s    # => "DE****3000"
+```
+
+Use `#redacted_s` wherever an IBAN would otherwise reach a log line, an error message or a support tool. It keeps the
+country code and the last four characters and masks everything between them. When the IBAN is short enough that the
+last four characters would give the rest away, they are masked too and only the country code remains.
+
 ### NxtSupport::Console.rake_cli_options
 A simple utility that uses Ruby's [OptionParser](https://docs.ruby-lang.org/en/2.1.0/OptionParser.html)
 to make it easier to pass CLI options to Rake tasks.

data/lib/nxt_support/util/iban.rb

@@ -0,0 +1,43 @@
+module NxtSupport
+  class Iban
+    require 'nxt_init'
+
+    include NxtInit
+    attr_init :iban
+
+    COUNTRY_CODE_LENGTH = 2
+    VISIBLE_CHARACTERS = 4
+    MASK = '****'.freeze
+
+    def self.normalize(iban)
+      new(iban: iban).normalize
+    end
+
+    def normalize
+      return iban unless iban.is_a?(String)
+
+      iban.upcase.gsub(/\s+/, '')
+    end
+
+    def to_s
+      normalize.to_s
+    end
+
+    def country_code
+      to_s.first(COUNTRY_CODE_LENGTH).presence
+    end
+
+    def last4
+      to_s.last(VISIBLE_CHARACTERS).presence
+    end
+
+    def redacted_s
+      normalized = to_s
+
+      return '' if normalized.empty?
+      return "#{country_code}#{MASK}" if normalized.length <= COUNTRY_CODE_LENGTH + VISIBLE_CHARACTERS
+
+      "#{country_code}#{MASK}#{last4}"
+    end
+  end
+end

data/lib/nxt_support/util.rb

@@ -4,3 +4,4 @@ require_relative 'util/enum/value'
 require_relative 'util/hash_translator'
 require_relative 'util/crystalizer'
 require_relative 'util/birth_date'
+require_relative 'util/iban'

data/lib/nxt_support/version.rb

@@ -1,3 +1,3 @@
 module NxtSupport
-  VERSION = "0.6.3".freeze
+  VERSION = "0.7.0".freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nxt_support
 version: !ruby/object:Gem::Version
-  version: 0.6.3
+  version: 0.7.0
 platform: ruby
 authors:
 - Nils Sommer
@@ -190,6 +190,7 @@ files:
 - lib/nxt_support/util/enum/value.rb
 - lib/nxt_support/util/enum_hash.rb
 - lib/nxt_support/util/hash_translator.rb
+- lib/nxt_support/util/iban.rb
 - lib/nxt_support/version.rb
 - nxt_support.gemspec
 homepage: https://github.com/nxt-insurance/nxt_support