qr-bills 1.0.10 → 1.0.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dbb88b03ca64ef109608926dc972fd7c53f1db3f325e47d652faac6d128ad327
-  data.tar.gz: 2c7443c74f2a307e4b7d93774454131e723fc73b310d0cc613efac3d92a86450
+  metadata.gz: d1e85a0928abfb125572539a4fbf99b331c789e2c21fd425b9c94736cb4fe8d8
+  data.tar.gz: 59788940942a55e4f30cf13a17c9ae8a20aeab4a925633bb8967cf2cc8c59fc2
 SHA512:
-  metadata.gz: 64d2bb70d15a823c5cf8fe007d4be5f206e299334eee7f8193eda58249d97356a128c1f2782d58c04d1e835a3e52a401a36ccc10973907893ced49c7b050d7e8
-  data.tar.gz: 1ebf9dbf4363102cb28f4c4b8781b26622f1fe69b4696c2e07fe83caa263cfbf376e566db5196dfa889389458f8e7866a6d5ca21c10e1a5f4b9cc41f44e828d2
+  metadata.gz: f9549f75f73c43ec82593358bb088454ce462eef5aa6ad71b2b83f95d432918dd30733abe0818435fe077797b1b9a01c7c9a5f2712bfd47a59596800789ae49b
+  data.tar.gz: 522b9bc62b6f80de240080390ca7a62a1ea116731bc2046d0339706c08b90f5a1be257bf31f5414bcb8a53529ada4cd410a3d7edf7195f958a22608551b2442e

data/lib/qr-bills.rb

@@ -26,10 +26,41 @@ module QRBills
     { params: qr_params, output: output }
   end
 
+  # Given a creditor's IBAN number, this method checks whether an IBAN is of the new qr or the legacy esr type.
+  # When generating a bill with a reference number, that number must be generated using the following method if this helper returns:
+  #     - :qr => create_creditor_reference
+  #     - :esr => create_esr_creditor_reference
+  def self.iban_type(iban)
+    return nil if iban.blank?
+    iban_institute_identifier = iban.strip.gsub(' ', '')[4..8].to_i
+    return iban_institute_identifier.between?(30_000, 31_999) ? :qr : :esr
+  end
+
   def self.create_creditor_reference(reference)
     QRCreditorReference.create(reference)
   end
 
+  # ESR reference should be considered "deprecated" and is here for backward compatibility
+  # This is based on: http://sahits.ch/blog/blog/2007/11/08/uberprufen-esr-referenz-nummer/
+  def self.create_esr_creditor_reference(reference)
+    raise ArgumentError, "#{QRExceptions::INVALID_PARAMETERS}: You must provide a 26 digit reference for ESR." unless reference.size == 26
+    raise ArgumentError, "#{QRExceptions::INVALID_PARAMETERS}: You must provide a valid digit for ESR." unless reference.to_i.to_s == reference
+
+    esr = "#{reference}0"
+    lookup_table = [0, 9, 4, 6, 8, 2, 7, 1, 3, 5]
+    next_val = 0
+
+    (0...esr.length - 1).each do |i|
+      ch = esr[i]
+      n = ch.to_i
+      index = (next_val + n) % 10
+      next_val = lookup_table[index]
+    end
+
+    result = (10 - next_val) % 10
+    return result
+  end
+
   def self.get_qr_params
     QRParams.get_qr_params
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: qr-bills
 version: !ruby/object:Gem::Version
-  version: 1.0.10
+  version: 1.0.11
 platform: ruby
 authors:
 - Damiano Radice
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-12-07 00:00:00.000000000 Z
+date: 2025-09-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: i18n
@@ -134,7 +134,7 @@ files:
 - web/assets/images/swiss_cross.svg
 homepage: https://github.com/damoiser/qr-bills
 licenses:
-- MIT
+- BSD-3-Clause
 metadata:
   bug_tracker_uri: https://github.com/damoiser/qr-bills/issues
   changelog_uri: https://github.com/damoiser/qr-bills/CHANGELOG.md
@@ -150,14 +150,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.1
+      version: 3.2.2
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: QR-bills support for swiss payments