creditcard-identifier 2.0.1 → 2.2.0

data/lib/creditcard_identifier.rb

@@ -8,7 +8,34 @@ require_relative 'creditcard_identifier/brands_detailed'
 #
 # This module provides credit card validation using bin-cc data.
 module CreditcardIdentifier
-  VERSION = '2.0.0'
+  VERSION = '2.1.0'
+
+  # Luhn lookup table for doubling digits
+  LUHN_LOOKUP = [0, 2, 4, 6, 8, 1, 3, 5, 7, 9].freeze
+
+  ##
+  # Validate a credit card number using the Luhn algorithm
+  #
+  # @param number [String] Credit card number (digits only)
+  # @return [Boolean] true if valid according to Luhn algorithm
+  # @raise [TypeError] if number is not a string
+  def self.luhn(number)
+    raise TypeError, 'Expected string input' unless number.is_a?(String)
+    return false if number.empty?
+
+    total = 0
+    x2 = true
+
+    (number.length - 1).downto(0) do |i|
+      value = number[i].ord - 48
+      return false if value < 0 || value > 9
+
+      x2 = !x2
+      total += x2 ? LUHN_LOOKUP[value] : value
+    end
+
+    (total % 10).zero?
+  end
 
   ##
   # Credit card validator using bin-cc data.
@@ -31,11 +58,25 @@ module CreditcardIdentifier
     def find_brand(card_number, detailed: false)
       return nil if card_number.nil? || card_number.empty?
 
-      brand = @brands.find do |b|
+      # Collect all matching brands
+      matching_brands = @brands.select do |b|
         b[:regexp_full].match?(card_number)
       end
 
-      return nil unless brand
+      return nil if matching_brands.empty?
+
+      # Resolve priority: a brand with priority_over takes precedence
+      brand = matching_brands.first
+      if matching_brands.length > 1
+        matching_names = matching_brands.map { |b| b[:name] }
+        matching_brands.each do |candidate|
+          priority_over = candidate[:priority_over] || []
+          if priority_over.any? { |p| matching_names.include?(p) }
+            brand = candidate
+            break
+          end
+        end
+      end
 
       if detailed
         detailed_brand = @brands_detailed.find { |b| b[:scheme] == brand[:name] }
@@ -132,6 +173,15 @@ module CreditcardIdentifier
     def list_brands
       @brands.map { |b| b[:name] }
     end
+
+    ##
+    # Validate a credit card number using the Luhn algorithm
+    #
+    # @param number [String] Credit card number (digits only)
+    # @return [Boolean] true if valid according to Luhn algorithm
+    def luhn(number)
+      CreditcardIdentifier.luhn(number)
+    end
   end
 
   # Module-level convenience methods

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: creditcard-identifier
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.2.0
 platform: ruby
 authors:
 - Renato Viço
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-11 00:00:00.000000000 Z
+date: 2026-01-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest