verifiabl-issuer 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 619853ce9733f541d03c4f5267ff59da66383941256b56970953bfec703f6600
-  data.tar.gz: 2c3b3bb84032287482bbde88fca5e85c947b6f557da73e165f4c5a593e629d44
+  metadata.gz: b7c622f96124e2196fcc336d8295d30fef83a2efc296890d841aec4ef8376e50
+  data.tar.gz: c0e18b541a27073c6026703acd7e8eeae0b1ce6867f55f8d4847451b9eaef812
 SHA512:
-  metadata.gz: a987cf173047507e67e5e693bcba5b59cbc914818261dddc1edfbeecf3cc5609a70f3db96e5da7b3a8e05f4aaf09ce6aab7acb22efe3665b622f1ab2a2a95f9f
-  data.tar.gz: 25180a6200be501ef89c6a647c0975018c14e7b34084c58ed8430e679a86f0fac38752f8c3591df56b8bda16a2084cf545f469f1ddb80eddcc23b76718dd4d36
+  metadata.gz: d36cfeaf56c836a4cd99d5786697668664b9003bf15c3689a50034bb1e9285aa93675ace858eff1cab65b6033ee64bffb3656290a61bd9c11e643881aa83918e
+  data.tar.gz: dd8bd433cd88d3ab01373608eab57476afbb2770d922a4c0f22ea238dd8d0d2bd62a154a8aa30699785c68b3e8efb7a24dd0aaf93a9d2ae3b159cfeb9408bc64

data/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to the Verifiabl Ruby SDK will be documented in this file.
 
 ## Unreleased
 
+## [1.0.1] - 2026-10-20
+
+### Changed
+
+- AU2 and NZ2 codes may be Symbols, such as `currency: :AUD` or
+  `type: :lump_sum`. The gem converts them to Strings before its checks, so
+  every check treats both forms alike. Amounts must still be Strings.
+
+### Fixed
+
+- An AU2 earnings line with `type: :lump_sum` (a Symbol) and no
+  `lump_sum_type` now raises `ArgumentError`, as the String form already did.
+  1.0.0 sent it without the code.
+
 ## [1.0.0] - 2026-10-19
 
 First stable release. The public API now follows Semantic Versioning.

data/README.md

@@ -9,7 +9,7 @@ client, RBS signatures, and packed-gem consumer qualification.
 Add the stable release to your bundle:
 
 ```ruby
-gem "verifiabl-issuer", "1.0.0"
+gem "verifiabl-issuer", "1.0.1"
 ```
 
 Then run `bundle install`.
@@ -225,7 +225,8 @@ both jurisdictions. An AU2 `lump_sum` line takes a `lump_sum_type` from
 an `etp_component` from `ETP_COMPONENTS`. Use their strings in your normal
 payslip hash; the lists do not restrict input or add local enum validation,
 and the API may accept a new code before this gem is updated. The gem raises
-before sending an AU2 `lump_sum` line without a `lump_sum_type`.
+before sending an AU2 `lump_sum` line without a `lump_sum_type`. A code may
+also be a Symbol, such as `type: :lump_sum`; the gem sends it as a String.
 Printed-text fields such as `tax_code` and `pay_cycle` are not code sets.
 
 ### Self-managed barcode flow

data/lib/verifiabl/issuer/non_pii_v2.rb

@@ -12,9 +12,11 @@ module Verifiabl
 
       module_function
 
-      def validate!(schema, payload)
-        check!(FIELDS.fetch(schema), payload, "payslip_non_pii")
-        check_lump_sum_types!(payload) if schema == AUSTRALIAN_PAYSLIP_V2_SCHEMA
+      # Returns the payload with Symbol codes as Strings, so later checks see what JSON encoding sends.
+      def to_wire!(schema, payload)
+        wire = convert!(FIELDS.fetch(schema), payload, "payslip_non_pii")
+        check_lump_sum_types!(wire) if schema == AUSTRALIAN_PAYSLIP_V2_SCHEMA
+        wire
       end
 
       # The API still accepts a bare lump sum from older SDKs, but a lump sum without its STP2 code
@@ -28,45 +30,48 @@ module Verifiabl
       end
       private_class_method :check_lump_sum_types!
 
-      def check!(allowed, value, path)
+      def convert!(allowed, value, path)
         case allowed
-        when Hash then check_object!(allowed, value, path)
-        when Array then check_array!(allowed.first, value, path)
-        when "decimal" then check_decimal!(value, path)
-        else check_scalar!(value, path)
+        when Hash then convert_object!(allowed, value, path)
+        when Array then convert_array!(allowed.first, value, path)
+        when "decimal" then decimal!(value, path)
+        else scalar!(value, path)
         end
       end
-      private_class_method :check!
+      private_class_method :convert!
 
-      def check_object!(allowed, value, path)
+      def convert_object!(allowed, value, path)
         raise ArgumentError, "#{path} must be an object" unless value.is_a?(Hash)
 
-        value.each do |key, child|
+        value.to_h do |key, child|
           raise ArgumentError, "#{path}.#{key} is not permitted" unless allowed.key?(key)
 
-          check!(allowed.fetch(key), child, "#{path}.#{key}")
+          [key, convert!(allowed.fetch(key), child, "#{path}.#{key}")]
         end
       end
-      private_class_method :check_object!
+      private_class_method :convert_object!
 
-      def check_array!(allowed, value, path)
+      def convert_array!(allowed, value, path)
         raise ArgumentError, "#{path} must be an array" unless value.is_a?(Array)
 
-        value.each_with_index { |child, index| check!(allowed, child, "#{path}[#{index}]") }
+        value.each_with_index.map { |child, index| convert!(allowed, child, "#{path}[#{index}]") }
       end
-      private_class_method :check_array!
+      private_class_method :convert_array!
 
-      def check_decimal!(value, path)
-        return if value.is_a?(String) && DECIMAL_PATTERN.match?(value)
+      # Amounts stay Strings only, so the SDK never guesses at a number's text.
+      def decimal!(value, path)
+        return value if value.is_a?(String) && DECIMAL_PATTERN.match?(value)
 
         raise ArgumentError, "#{path} must be a plain decimal String, for example \"1234.56\""
       end
-      private_class_method :check_decimal!
+      private_class_method :decimal!
 
-      def check_scalar!(value, path)
+      def scalar!(value, path)
         raise ArgumentError, "#{path} must be a scalar" if value.is_a?(Hash) || value.is_a?(Array)
+
+        value.is_a?(Symbol) ? value.to_s : value
       end
-      private_class_method :check_scalar!
+      private_class_method :scalar!
     end
   end
 end

data/lib/verifiabl/issuer/serialization.rb

@@ -12,7 +12,10 @@ module Verifiabl
       def registration_to_wire(schema:, issued_at:, payslip_non_pii:, encryption_metadata:)
         Validation.registration!(schema: schema, issued_at: issued_at, payslip_non_pii: payslip_non_pii, encryption_metadata: encryption_metadata)
         wire_payslip = stringify_keys(payslip_non_pii)
-        NonPiiV2.validate!(schema, wire_payslip) if [AUSTRALIAN_PAYSLIP_V2_SCHEMA, NEW_ZEALAND_PAYSLIP_V2_SCHEMA].include?(schema)
+        if [AUSTRALIAN_PAYSLIP_V2_SCHEMA, NEW_ZEALAND_PAYSLIP_V2_SCHEMA].include?(schema)
+          wire_payslip = NonPiiV2.to_wire!(schema, wire_payslip)
+          Validation.v2_currency!(wire_payslip)
+        end
         {
           "schema" => schema,
           "issued_at" => serialize_time(issued_at),

data/lib/verifiabl/issuer/validation.rb

@@ -14,7 +14,7 @@ module Verifiabl
 
       def registration!(schema:, issued_at:, payslip_non_pii:, encryption_metadata:)
         registration_envelope!(schema:, issued_at:, encryption_metadata:)
-        validate_payslip_non_pii!(schema, payslip_non_pii)
+        validate_payslip_non_pii!(payslip_non_pii)
       end
 
       def registration_envelope!(schema:, issued_at:, encryption_metadata:)
@@ -55,20 +55,19 @@ module Verifiabl
       end
       private_class_method :validate_encryption_metadata!
 
-      def validate_payslip_non_pii!(schema, payslip_non_pii)
+      def validate_payslip_non_pii!(payslip_non_pii)
         raise ArgumentError, "payslip_non_pii must be a Hash" unless payslip_non_pii.is_a?(Hash)
         validate_iso_date!(value(payslip_non_pii, :period_start), "period_start") if key?(payslip_non_pii, :period_start)
         validate_iso_date!(value(payslip_non_pii, :period_end), "period_end") if key?(payslip_non_pii, :period_end)
-        validate_v2_currency!(payslip_non_pii) if [AUSTRALIAN_PAYSLIP_V2_SCHEMA, NEW_ZEALAND_PAYSLIP_V2_SCHEMA].include?(schema)
       end
       private_class_method :validate_payslip_non_pii!
 
-      def validate_v2_currency!(payslip_non_pii)
-        return if SUPPORTED_V2_CURRENCIES.include?(value(payslip_non_pii, :currency))
+      # Takes the wire payslip, so a Symbol code has already become a String.
+      def v2_currency!(wire_payslip)
+        return if SUPPORTED_V2_CURRENCIES.include?(wire_payslip["currency"])
 
         raise ArgumentError, "currency is required and must be a supported ISO 4217 currency code, for example AUD"
       end
-      private_class_method :validate_v2_currency!
 
       def validate_issued_at!(issued_at)
         return if issued_at.is_a?(Time)

data/lib/verifiabl/issuer/version.rb

@@ -2,6 +2,6 @@
 
 module Verifiabl
   module Issuer
-    VERSION = "1.0.0"
+    VERSION = "1.0.1"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: verifiabl-issuer
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Verifiabl
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-19 00:00:00.000000000 Z
+date: 2026-10-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64