creditcard-identifier 2.0.1 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c88cdee72a10369be227c5e17055b5322411525e2c5cf1dbedfb631141b2bd4f
-  data.tar.gz: e9b62ef2301e4f2eb7c3deac99c526eb3c33a24edd006289f9f1cbbf10860a66
+  metadata.gz: 1ae87b47647670786be04ec29dbb4257da90c3264e1fdb5cb57df74cd6dc8c2b
+  data.tar.gz: 6d209a5a775ea4e95f9dce3daa5b9a190fa79904e72aae23532438e42b0c3a6c
 SHA512:
-  metadata.gz: 600ef8ee4b9aee759f362d85a290d8b2b0032d3cc9bba66d9bb2c17fe0b163f196a7824b2dfd8846142120c74817421ca73693e76d05337dcc729a647c1f62aa
-  data.tar.gz: 5da351094afc901f8960a1e054e7f9d27e086268f70dbef70967b47a7038bb5c5d385ab43fa1d005abacc708c9210d3d473aa8ba4ed5908dcd8e80d3ce2d29dd
+  metadata.gz: 613ec2e5e2e481e1fabb607c8f27b520ed0ab1d8fb8aa55cdf45c7069e1654afc22599a4bcf1db125db888daa8352277db00ecb92bb6765f8b9499b25cca013e
+  data.tar.gz: 8a60d7b35b49a581f47a514ca12f04436206d132d2dd9c315f1a6f204d7c345556e4a077d621b8a0e00c8476a7de7b4448e6f3c65267770f72e30cbe3339fe45

data/README.md

@@ -89,6 +89,14 @@ puts detailed
 brands = validator.list_brands
 puts brands
 # ['amex', 'aura', 'banesecard', 'diners', 'discover', 'elo', 'hipercard', 'jcb', 'maestro', 'mastercard', 'unionpay', 'visa']
+
+# Validate card number using Luhn algorithm
+is_valid = CreditcardIdentifier.luhn('4012001037141112')
+puts is_valid  # true
+
+# Or using validator instance
+is_valid = validator.luhn('4012001037141112')
+puts is_valid  # true
 ```
 
 ## API
@@ -163,6 +171,16 @@ List all supported brands.
 
 **Returns:** (Array<String>) List of brand names
 
+#### `luhn(number)`
+Validate a credit card number using the Luhn algorithm.
+
+**Parameters:**
+- `number` (String): Credit card number (digits only)
+
+**Returns:** (Boolean) true if valid according to Luhn algorithm
+
+**Raises:** TypeError if input is not a string
+
 ## Data Source
 
 This library uses the BIN data from the [bin-cc project](https://github.com/renatovico/bin-cc).

data/lib/creditcard_identifier/brands.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Auto-generated by bin-cc build - DO NOT EDIT
-# Generated: 2026-01-11T20:57:15.838Z
+# Generated: 2026-01-11T21:09:29.401Z
 
 module CreditcardIdentifier
   # Credit card brand data

data/lib/creditcard_identifier/brands_detailed.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Auto-generated by bin-cc build - DO NOT EDIT
-# Generated: 2026-01-11T20:57:15.839Z
+# Generated: 2026-01-11T21:09:29.401Z
 
 module CreditcardIdentifier
   # Credit card brand data (detailed)

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.
@@ -132,6 +159,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,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: creditcard-identifier
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.1.0
 platform: ruby
 authors:
 - Renato Viço