Introduce subtypes of InvalidArgumentException

src/Exception/CurrencyMismatchException.php

@@ -0,0 +1,9 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Money\Exception;
+
+final class CurrencyMismatchException extends InvalidArgumentException
+{
+}

src/Exception/DivisionByZeroException.php

@@ -0,0 +1,9 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Money\Exception;
+
+final class DivisionByZeroException extends InvalidArgumentException
+{
+}

src/Exception/InvalidArgumentException.php

@@ -7,17 +7,26 @@
 use InvalidArgumentException as CoreInvalidArgumentException;
 use Money\Exception;
 
-final class InvalidArgumentException extends CoreInvalidArgumentException implements Exception
+/**
+ * @internal
+ */
+class InvalidArgumentException extends CoreInvalidArgumentException implements Exception
 {
     /** @phpstan-pure */
-    public static function divisionByZero(): self
+    public static function divisionByZero(): DivisionByZeroException
     {
-        return new self('Cannot compute division with a zero divisor');
+        return new DivisionByZeroException('Cannot compute division with a zero divisor');
     }
 
     /** @phpstan-pure */
-    public static function moduloByZero(): self
+    public static function moduloByZero(): ModuloByZeroException
     {
-        return new self('Cannot compute modulo with a zero divisor');
+        return new ModuloByZeroException('Cannot compute modulo with a zero divisor');
+    }
+
+    /** @phpstan-pure */
+    public static function currencyMismatch(): CurrencyMismatchException
+    {
+        return new CurrencyMismatchException('Currencies must be identical');
     }
 }

src/Exception/ModuloByZeroException.php

@@ -0,0 +1,9 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Money\Exception;
+
+final class ModuloByZeroException extends InvalidArgumentException
+{
+}

src/Money.php

@@ -4,9 +4,9 @@
 
 namespace Money;
 
-use InvalidArgumentException;
 use JsonSerializable;
 use Money\Calculator\BcMathCalculator;
+use Money\Exception\InvalidArgumentException;
 
 use function array_fill;
 use function array_keys;
@@ -135,7 +135,7 @@ public function compare(Money $other): int
     {
         // Note: non-strict equality is intentional here, since `Currency` is `final` and reliable.
         if ($this->currency != $other->currency) {
-            throw new InvalidArgumentException('Currencies must be identical');
+            throw InvalidArgumentException::currencyMismatch();
         }
 
         // @phpstan-ignore impure.staticPropertyAccess, possiblyImpure.methodCall
@@ -209,7 +209,7 @@ public function add(Money ...$addends): Money
         foreach ($addends as $addend) {
             // Note: non-strict equality is intentional here, since `Currency` is `final` and reliable.
             if ($this->currency != $addend->currency) {
-                throw new InvalidArgumentException('Currencies must be identical');
+                throw InvalidArgumentException::currencyMismatch();
             }
 
             // @phpstan-ignore impure.staticPropertyAccess, possiblyImpure.methodCall
@@ -232,7 +232,7 @@ public function subtract(Money ...$subtrahends): Money
         foreach ($subtrahends as $subtrahend) {
             // Note: non-strict equality is intentional here, since `Currency` is `final` and reliable.
             if ($this->currency != $subtrahend->currency) {
-                throw new InvalidArgumentException('Currencies must be identical');
+                throw InvalidArgumentException::currencyMismatch();
             }
 
             // @phpstan-ignore impure.staticPropertyAccess, possiblyImpure.methodCall
@@ -291,7 +291,7 @@ public function mod(Money|int|string $divisor): Money
         if ($divisor instanceof self) {
             // Note: non-strict equality is intentional here, since `Currency` is `final` and reliable.
             if ($this->currency != $divisor->currency) {
-                throw new InvalidArgumentException('Currencies must be identical');
+                throw InvalidArgumentException::currencyMismatch();
             }
 
             $divisor = $divisor->amount;
@@ -385,7 +385,7 @@ public function ratioOf(Money $money): string
 
         // Note: non-strict equality is intentional here, since `Currency` is `final` and reliable.
         if ($this->currency != $money->currency) {
-            throw new InvalidArgumentException('Currencies must be identical');
+            throw InvalidArgumentException::currencyMismatch();
         }
 
         return self::$calculator::divide($this->amount, $money->amount);

tests/MoneyTest.php

@@ -6,6 +6,7 @@
 
 use InvalidArgumentException;
 use Money\Currency;
+use Money\Exception\CurrencyMismatchException;
 use Money\Money;
 use PHPUnit\Framework\TestCase;
 
@@ -294,7 +295,7 @@ public function itThrowsWhenCalculatingModulusOfDifferentCurrencies(): void
         $money      = new Money(self::AMOUNT, new Currency(self::CURRENCY));
         $rightMoney = new Money(self::OTHER_AMOUNT, new Currency(self::OTHER_CURRENCY));
 
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(CurrencyMismatchException::class);
 
         $money->mod($rightMoney);
     }
@@ -442,7 +443,7 @@ public function itThrowsWhenComparingDifferentCurrencies(): void
     {
         $money = new Money('5', new Currency(self::CURRENCY));
 
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(CurrencyMismatchException::class);
 
         $money->compare(new Money('5', new Currency('SOME')));
     }