feat: update VerificationFactoryInterface

src/QUI/Verification/Interface/VerificationFactoryInterface.php

@@ -3,6 +3,8 @@
 namespace QUI\Verification\Interface;
 
 use QUI\PhoneApi\Entity\PhoneNumber;
+use QUI\Verification\Entity\Address;
+use QUI\Verification\Entity\AddressVerification;
 use QUI\Verification\Entity\LinkVerification;
 use QUI\Verification\Entity\PhoneNumberVerification;
 use QUI\Verification\Enum\PhoneNumberVerificationStrategy;
@@ -50,4 +52,26 @@ public function createPhoneNumberVerification(
         ?string $verificationCode = null,
         bool $overwriteExisting = false
     ): PhoneNumberVerification;
+
+    /**
+     * Create verification for verifying an address via code that is sent via letter.
+     *
+     * @param string $identifier - A custom unique identifier that is used to determine identical verifications;
+     * e.g. an email address for an email address verification process.
+     * @param Address $address
+     * @param AddressVerificationHandlerInterface $verificationHandler
+     * @param array<string|int,mixed> $customData (optional) - Custom data that is stored with the Verification
+     * @param string|null $verificationCode (optional) - The verification code used. If NULL, generate random code
+     * @param bool $overwriteExisting (optional) - Overwrite Verification with identical
+     * identifier and source class [default: false]
+     * @return AddressVerification
+     */
+    public function createAddressVerification(
+        string $identifier,
+        Address $address,
+        AddressVerificationHandlerInterface $verificationHandler,
+        array $customData = [],
+        ?string $verificationCode = null,
+        bool $overwriteExisting = false
+    ): AddressVerification;
 }