Add Base32 decoding method and implement SecretOtp class with serialization methods

src/Socialbox/Objects/Standard/SecretOtp.php

@@ -0,0 +1,26 @@
+<?php
+
+    namespace Socialbox\Objects\Standard;
+
+    use Socialbox\Interfaces\SerializableInterface;
+
+    class SecretOtp implements SerializableInterface
+    {
+
+
+        /**
+         * @inheritDoc
+         */
+        public static function fromArray(array $data): object
+        {
+            // TODO: Implement fromArray() method.
+        }
+
+        /**
+         * @inheritDoc
+         */
+        public function toArray(): array
+        {
+            // TODO: Implement toArray() method.
+        }
+    }

tests/Helper.php

@@ -106,4 +106,33 @@
         {
             return new SocialClient(self::generateRandomPeer($domain, $length, $prefix));
         }
+
+        /**
+         * Encodes a string to Base32.
+         *
+         * @param string $input The string to be encoded.
+         * @return string Returns the encoded string.
+         */
+        public static function decodeBase32(string $input): string
+        {
+            $input = strtoupper($input);
+            $v = 0;
+            $k = 0;
+            $chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ234567';
+            $output = '';
+
+            for ($i = 0; $i < strlen($input); $i++)
+            {
+                $v = ($v << 5) | strpos($chars, $input[$i]);
+                $k += 5;
+
+                if ($k >= 8)
+                {
+                    $k -= 8;
+                    $output .= chr(($v >> $k) & 0xFF);
+                }
+            }
+
+            return $output;
+        }
     }

tests/Socialbox/SettingsTest.php

@@ -4,6 +4,7 @@
 
     use Helper;
     use PHPUnit\Framework\TestCase;
+    use Socialbox\Classes\OtpCryptography;
     use Socialbox\Enums\Flags\SessionFlags;
     use Socialbox\Enums\PrivacyState;
     use Socialbox\Enums\Types\InformationFieldName;
@@ -545,11 +546,36 @@
             $this->assertTrue($testClient->settingsSetPassword('SecretTestingPassword123'));
             $this->assertTrue($testClient->getSessionState()->isAuthenticated());
 
-            $secret = $testClient->settingsSetOtp('SecretTestingPassword123');
+            $totpUri = $testClient->settingsSetOtp('SecretTestingPassword123');
-            $this->assertNotEmpty($secret);
+            $this->assertNotEmpty($totpUri);
 
             $testClient = new SocialClient($testAddress);
             $this->assertFalse($testClient->getSessionState()->isAuthenticated());
             $this->assertTrue($testClient->getSessionState()->containsFlag(SessionFlags::VER_OTP));
+            $this->assertTrue($testClient->getSessionState()->containsFlag(SessionFlags::VER_PASSWORD));
+
+            $this->assertTrue($testClient->verificationPasswordAuthentication('SecretTestingPassword123'));
+
+            // Parse the TOTP URI
+            $parsedUri = parse_url($totpUri);
+            parse_str($parsedUri['query'], $queryParams);
+
+            // Extract secret and other parameters
+            $secret = $queryParams['secret'];
+            $algorithm = strtolower(str_replace('SHA', 'sha', $queryParams['algorithm'] ?? 'sha512'));
+            $digits = (int)($queryParams['digits'] ?? 6);
+            $period = (int)($queryParams['period'] ?? 30);
+
+            // Generate the OTP
+            $otp = OtpCryptography::generateOTP(
+                $secret,
+                $period,
+                $digits,
+                null,
+                $algorithm
+            );
+
+            // Verify the OTP
+            $this->assertTrue($testClient->verificationOtpAuthentication($otp));
         }
     }