Added the ability to use a custom validator

Author: andrey-helldar

README.md

@@ -63,6 +63,11 @@
             "DragonCode\\CardNumber\\": "src/"
         }
     },
+    "autoload-dev": {
+        "psr-4": {
+            "Tests\\": "tests/"
+        }
+    },
     "config": {
         "allow-plugins": {
             "dragon-code/codestyler": true,

composer.json

@@ -14,43 +14,50 @@
 use DragonCode\CardNumber\Validators\Banks\DinersClub;
 use DragonCode\CardNumber\Validators\Banks\Discovery;
 use DragonCode\CardNumber\Validators\Banks\Forbrugsforeningen;
-use DragonCode\CardNumber\Validators\Banks\HiperCard;
+use DragonCode\CardNumber\Validators\Banks\HiperCardValidator;
 use DragonCode\CardNumber\Validators\Banks\Jcb;
 use DragonCode\CardNumber\Validators\Banks\Maestro;
-use DragonCode\CardNumber\Validators\Banks\MasterCard;
+use DragonCode\CardNumber\Validators\Banks\MasterCardValidator;
 use DragonCode\CardNumber\Validators\Banks\Mir;
 use DragonCode\CardNumber\Validators\Banks\Troy;
 use DragonCode\CardNumber\Validators\Banks\UnionPay;
 use DragonCode\CardNumber\Validators\Banks\Visa;
 use DragonCode\CardNumber\Validators\Banks\VisaElectron;
-use DragonCode\CardNumber\Validators\DefaultCard;
+use DragonCode\CardNumber\Validators\CardValidator;
+use DragonCode\CardNumber\Validators\DefaultCardValidator;
 use DragonCode\CardNumber\Validators\Loyalty\Chars;
 use DragonCode\CardNumber\Validators\Loyalty\RalfRinger;
 use DragonCode\CardNumber\Validators\Loyalty\YvesRocher;
 
+use function is_a;
+
 class CardNumber
 {
     public static function isValid(int|string $number, CardType|string|null $cardType = null): bool
     {
+        if (is_a($cardType, CardValidator::class, true)) {
+            return $cardType::isValid($number);
+        }
+
         return match (static::detectCardType($cardType)) {
             CardType::americanExpress    => AmericanExpress::isValid($number),
             CardType::chars              => Chars::isValid($number),
             CardType::dankort            => Dankort::isValid($number),
             CardType::dinersClub         => DinersClub::isValid($number),
             CardType::discovery          => Discovery::isValid($number),
             CardType::forbrugsforeningen => Forbrugsforeningen::isValid($number),
-            CardType::hiperCard          => HiperCard::isValid($number),
+            CardType::hiperCard          => HiperCardValidator::isValid($number),
             CardType::jcb                => Jcb::isValid($number),
             CardType::maestro            => Maestro::isValid($number),
-            CardType::masterCard         => MasterCard::isValid($number),
+            CardType::masterCard         => MasterCardValidator::isValid($number),
             CardType::mir                => Mir::isValid($number),
             CardType::ralfRinger         => RalfRinger::isValid($number),
             CardType::troy               => Troy::isValid($number),
             CardType::unionPay           => UnionPay::isValid($number),
             CardType::visa               => Visa::isValid($number),
             CardType::visaElectron       => VisaElectron::isValid($number),
             CardType::yvesRocher         => YvesRocher::isValid($number),
-            default                      => DefaultCard::isValid($number)
+            default                      => DefaultCardValidator::isValid($number)
         };
     }
 

src/CardNumber.php

@@ -4,9 +4,9 @@
 
 namespace DragonCode\CardNumber\Validators\Banks;
 
-use DragonCode\CardNumber\Validators\Card;
+use DragonCode\CardNumber\Validators\CardValidator;
 
-class AmericanExpress extends Card
+class AmericanExpress extends CardValidator
 {
     protected static ?string $pattern = '/^3[47][0-9]/';
 

src/Validators/Banks/AmericanExpress.php

@@ -4,9 +4,9 @@
 
 namespace DragonCode\CardNumber\Validators\Banks;
 
-use DragonCode\CardNumber\Validators\Card;
+use DragonCode\CardNumber\Validators\CardValidator;
 
-class Dankort extends Card
+class Dankort extends CardValidator
 {
     protected static ?string $pattern = '/^5019/';
 }

src/Validators/Banks/Dankort.php

@@ -4,9 +4,9 @@
 
 namespace DragonCode\CardNumber\Validators\Banks;
 
-use DragonCode\CardNumber\Validators\Card;
+use DragonCode\CardNumber\Validators\CardValidator;
 
-class DinersClub extends Card
+class DinersClub extends CardValidator
 {
     protected static ?string $pattern = '/^3(0[0-5]|[68][0-9])[0-9]/';
 

src/Validators/Banks/DinersClub.php

@@ -4,9 +4,9 @@
 
 namespace DragonCode\CardNumber\Validators\Banks;
 
-use DragonCode\CardNumber\Validators\Card;
+use DragonCode\CardNumber\Validators\CardValidator;
 
-class Discovery extends Card
+class Discovery extends CardValidator
 {
     protected static ?string $pattern = '/^6(011|22126|22925|4[4-9]|5)/';
 }

src/Validators/Banks/Discovery.php

@@ -4,9 +4,9 @@
 
 namespace DragonCode\CardNumber\Validators\Banks;
 
-use DragonCode\CardNumber\Validators\Card;
+use DragonCode\CardNumber\Validators\CardValidator;
 
-class Forbrugsforeningen extends Card
+class Forbrugsforeningen extends CardValidator
 {
     protected static ?string $pattern = '/^600/';
 }

src/Validators/Banks/Forbrugsforeningen.php

@@ -4,9 +4,9 @@
 
 namespace DragonCode\CardNumber\Validators\Banks;
 
-use DragonCode\CardNumber\Validators\Card;
+use DragonCode\CardNumber\Validators\CardValidator;
 
-class HiperCard extends Card
+class HiperCardValidator extends CardValidator
 {
     protected static ?string $pattern = '/^(606282\d{7}(\d{3})?)|(3841\d{15})/';
 

src/Validators/Banks/HiperCard.php …/Validators/Banks/HiperCardValidator.phpsrc/Validators/Banks/HiperCard.php renamed to src/Validators/Banks/HiperCardValidator.php src/Validators/Banks/HiperCard.php renamed to src/Validators/Banks/HiperCardValidator.php

@@ -4,9 +4,9 @@
 
 namespace DragonCode\CardNumber\Validators\Banks;
 
-use DragonCode\CardNumber\Validators\Card;
+use DragonCode\CardNumber\Validators\CardValidator;
 
-class Jcb extends Card
+class Jcb extends CardValidator
 {
     protected static ?string $pattern = '/^(?:2131|1800|35\d{3})/';