From 7b1ba42e66ca7ea8f9052cd96c206c2691edeefe Mon Sep 17 00:00:00 2001
From: D3strukt0r <dev@d3strukt0r.dev>
Date: Mon, 29 Jun 2026 22:00:00 +0200
Subject: [PATCH 01/13] style: reformat the source to the new coding standard

Apply the PHP-CS-Fixer ruleset across src/ (Yoda conditions removed, fully-qualified built-in functions and classes, import cleanups, PHPDoc ordering, concatenation spacing). No behaviour changes; the actual bug fixes follow in their own commits so they aren't buried in reformatting.
---
 src/Exception/NotVotifierException.php        |  6 +-
 .../NuVotifierChallengeInvalidException.php   |  4 +-
 src/Exception/NuVotifierException.php         |  6 +-
 .../NuVotifierSignatureInvalidException.php   |  4 +-
 .../NuVotifierUnknownServiceException.php     |  4 +-
 .../NuVotifierUsernameTooLongException.php    |  4 +-
 .../Socket/NoConnectionException.php          |  6 +-
 .../Socket/PackageNotReceivedException.php    |  6 +-
 .../Socket/PackageNotSentException.php        |  6 +-
 src/Server/GenericServer.php                  |  2 +-
 src/Server/NuVotifier.php                     | 58 +++++++++----------
 src/Server/ServerInterface.php                |  9 ++-
 src/Server/Votifier.php                       | 48 ++++++++-------
 src/Socket.php                                | 14 ++---
 src/Vote/ClassicVote.php                      |  8 +--
 src/Vote/VoteInterface.php                    | 14 ++---
 16 files changed, 82 insertions(+), 117 deletions(-)

diff --git a/src/Exception/NotVotifierException.php b/src/Exception/NotVotifierException.php
index 19dcc63..fe62c89 100644
--- a/src/Exception/NotVotifierException.php
+++ b/src/Exception/NotVotifierException.php
@@ -12,12 +12,8 @@
 
 namespace D3strukt0r\Votifier\Client\Exception;
 
-use Exception;
-
 /**
  * Class NotVotifierException
  * The connection does not belong to Votifier.
  */
-class NotVotifierException extends Exception
-{
-}
+class NotVotifierException extends \Exception {}
diff --git a/src/Exception/NuVotifierChallengeInvalidException.php b/src/Exception/NuVotifierChallengeInvalidException.php
index 41c0d55..07fc749 100644
--- a/src/Exception/NuVotifierChallengeInvalidException.php
+++ b/src/Exception/NuVotifierChallengeInvalidException.php
@@ -16,6 +16,4 @@
  * Class NuVotifierChallengeInvalidException
  * Challenge is not valid.
  */
-class NuVotifierChallengeInvalidException extends NuVotifierException
-{
-}
+class NuVotifierChallengeInvalidException extends NuVotifierException {}
diff --git a/src/Exception/NuVotifierException.php b/src/Exception/NuVotifierException.php
index 1a6ba17..a7dc598 100644
--- a/src/Exception/NuVotifierException.php
+++ b/src/Exception/NuVotifierException.php
@@ -12,8 +12,4 @@
 
 namespace D3strukt0r\Votifier\Client\Exception;
 
-use Exception;
-
-class NuVotifierException extends Exception
-{
-}
+class NuVotifierException extends \Exception {}
diff --git a/src/Exception/NuVotifierSignatureInvalidException.php b/src/Exception/NuVotifierSignatureInvalidException.php
index 2afcf78..9748a88 100644
--- a/src/Exception/NuVotifierSignatureInvalidException.php
+++ b/src/Exception/NuVotifierSignatureInvalidException.php
@@ -16,6 +16,4 @@
  * Class NuVotifierSignatureInvalidException
  * Signature is not valid (invalid token?).
  */
-class NuVotifierSignatureInvalidException extends NuVotifierException
-{
-}
+class NuVotifierSignatureInvalidException extends NuVotifierException {}
diff --git a/src/Exception/NuVotifierUnknownServiceException.php b/src/Exception/NuVotifierUnknownServiceException.php
index 12eaa1d..df9ee9b 100644
--- a/src/Exception/NuVotifierUnknownServiceException.php
+++ b/src/Exception/NuVotifierUnknownServiceException.php
@@ -16,6 +16,4 @@
  * Class NuVotifierUnknownServiceException
  * Unknown service 'xxx'.
  */
-class NuVotifierUnknownServiceException extends NuVotifierException
-{
-}
+class NuVotifierUnknownServiceException extends NuVotifierException {}
diff --git a/src/Exception/NuVotifierUsernameTooLongException.php b/src/Exception/NuVotifierUsernameTooLongException.php
index 3baec55..71272f1 100644
--- a/src/Exception/NuVotifierUsernameTooLongException.php
+++ b/src/Exception/NuVotifierUsernameTooLongException.php
@@ -16,6 +16,4 @@
  * Class NuVotifierUsernameTooLongException
  * Username too long.
  */
-class NuVotifierUsernameTooLongException extends NuVotifierException
-{
-}
+class NuVotifierUsernameTooLongException extends NuVotifierException {}
diff --git a/src/Exception/Socket/NoConnectionException.php b/src/Exception/Socket/NoConnectionException.php
index 1b540a1..bcdabec 100644
--- a/src/Exception/Socket/NoConnectionException.php
+++ b/src/Exception/Socket/NoConnectionException.php
@@ -12,8 +12,4 @@
 
 namespace D3strukt0r\Votifier\Client\Exception\Socket;
 
-use Exception;
-
-class NoConnectionException extends Exception
-{
-}
+class NoConnectionException extends \Exception {}
diff --git a/src/Exception/Socket/PackageNotReceivedException.php b/src/Exception/Socket/PackageNotReceivedException.php
index 095dfae..4495a0f 100644
--- a/src/Exception/Socket/PackageNotReceivedException.php
+++ b/src/Exception/Socket/PackageNotReceivedException.php
@@ -12,12 +12,8 @@
 
 namespace D3strukt0r\Votifier\Client\Exception\Socket;
 
-use Exception;
-
 /**
  * Class PackageNotReceivedException
  * Unable to read server response.
  */
-class PackageNotReceivedException extends Exception
-{
-}
+class PackageNotReceivedException extends \Exception {}
diff --git a/src/Exception/Socket/PackageNotSentException.php b/src/Exception/Socket/PackageNotSentException.php
index dddb11a..9ca3879 100644
--- a/src/Exception/Socket/PackageNotSentException.php
+++ b/src/Exception/Socket/PackageNotSentException.php
@@ -12,12 +12,8 @@
 
 namespace D3strukt0r\Votifier\Client\Exception\Socket;
 
-use Exception;
-
 /**
  * Class PackageNotSentException
  * Couldn't write to remote host.
  */
-class PackageNotSentException extends Exception
-{
-}
+class PackageNotSentException extends \Exception {}
diff --git a/src/Server/GenericServer.php b/src/Server/GenericServer.php
index d06f352..7e66e54 100644
--- a/src/Server/GenericServer.php
+++ b/src/Server/GenericServer.php
@@ -46,7 +46,7 @@ abstract class GenericServer implements ServerInterface
      */
     public function getSocket(): Socket
     {
-        return null === $this->socket ? $this->socket = new Socket() : $this->socket;
+        return $this->socket === null ? $this->socket = new Socket() : $this->socket;
     }
 
     /**
diff --git a/src/Server/NuVotifier.php b/src/Server/NuVotifier.php
index d9201bd..0ec30cc 100644
--- a/src/Server/NuVotifier.php
+++ b/src/Server/NuVotifier.php
@@ -19,10 +19,6 @@
 use D3strukt0r\Votifier\Client\Exception\NuVotifierUnknownServiceException;
 use D3strukt0r\Votifier\Client\Exception\NuVotifierUsernameTooLongException;
 use D3strukt0r\Votifier\Client\Vote\VoteInterface;
-use DateTime;
-use InvalidArgumentException;
-
-use function count;
 
 /**
  * The Class to access a server which uses the plugin "NuVotifier".
@@ -35,7 +31,7 @@ class NuVotifier extends Votifier
     protected $protocolV2 = false;
 
     /**
-     * @var string|null The token from the config.yml
+     * @var null|string The token from the config.yml
      */
     protected $token;
 
@@ -66,7 +62,7 @@ public function setProtocolV2(bool $isProtocolV2): self
     /**
      * Gets the token from the config.yml.
      *
-     * @return string|null returns The token from the config.yml
+     * @return null|string returns The token from the config.yml
      */
     public function getToken(): ?string
     {
@@ -76,7 +72,7 @@ public function getToken(): ?string
     /**
      * Sets the token from the config.yml.
      *
-     * @param string|null $token The token from the config.yml
+     * @param null|string $token The token from the config.yml
      *
      * @return $this returns the class itself, for doing multiple things at once
      */
@@ -141,7 +137,7 @@ public function sendVote(VoteInterface ...$votes): void
             $challenge = mb_substr($headerParts[2], 0, -1);
 
             // Update the timestamp of the vote being sent
-            $vote->setTimestamp(new DateTime());
+            $vote->setTimestamp(new \DateTime());
 
             // Check if all variables have been set, to create a package
             $this->checkVariablesForPackage($vote);
@@ -160,16 +156,20 @@ public function sendVote(VoteInterface ...$votes): void
              * {"status":"error","cause":"CorruptedFrameException","error":"Username too long"} (over 16 characters)
              */
             $result = json_decode($socket->read(256));
-            if ('ok' !== $result->status) {
-                if ('Challenge is not valid' === $result->error) {
+            if ($result->status !== 'ok') {
+                if ($result->error === 'Challenge is not valid') {
                     throw new NuVotifierChallengeInvalidException();
-                } elseif (preg_match('/Unknown service \'(.*)\'/', $result->error)) {
+                }
+                if (preg_match('/Unknown service \'(.*)\'/', $result->error)) {
                     throw new NuVotifierUnknownServiceException();
-                } elseif ('Signature is not valid (invalid token?)' === $result->error) {
+                }
+                if ($result->error === 'Signature is not valid (invalid token?)') {
                     throw new NuVotifierSignatureInvalidException();
-                } elseif ('Username too long' === $result->error) {
+                }
+                if ($result->error === 'Username too long') {
                     throw new NuVotifierUsernameTooLongException();
                 }
+
                 throw new NuVotifierException('Unknown NuVotifier Exception');
             }
 
@@ -183,9 +183,9 @@ public function sendVote(VoteInterface ...$votes): void
      *
      * @param VoteInterface $vote The vote to check
      *
-     * @throws InvalidArgumentException If one required parameter wasn't set
+     * @throws \InvalidArgumentException If one required parameter wasn't set
      */
-    protected function checkVariablesForPackage(VoteInterface $vote)
+    protected function checkVariablesForPackage(VoteInterface $vote): void
     {
         if (!$this->isProtocolV2()) {
             parent::checkVariablesForSocket();
@@ -194,30 +194,30 @@ protected function checkVariablesForPackage(VoteInterface $vote)
         }
 
         if (
-            null === $vote->getServiceName()
-            || null === $vote->getUsername()
-            || null === $vote->getAddress()
-            || null === $vote->getTimestamp()
+            $vote->getServiceName() === null
+            || $vote->getUsername() === null
+            || $vote->getAddress() === null
+            || $vote->getTimestamp() === null
             || !isset($this->token)
         ) {
             $countError = 0;
             $errorMessage = '';
 
-            if (null === $vote->getServiceName()) {
+            if ($vote->getServiceName() === null) {
                 $errorMessage .= 'The host variable wasn\'t set with "->setServiceName(...)".';
                 ++$countError;
             }
-            if (null === $vote->getUsername()) {
+            if ($vote->getUsername() === null) {
                 $errorMessage .= $countError > 0 ? ' ' : '';
                 $errorMessage .= 'The host variable wasn\'t set with "->setUsername(...)".';
                 ++$countError;
             }
-            if (null === $vote->getAddress()) {
+            if ($vote->getAddress() === null) {
                 $errorMessage .= $countError > 0 ? ' ' : '';
                 $errorMessage .= 'The host variable wasn\'t set with "->setAddress(...)".';
                 ++$countError;
             }
-            if (null === $vote->getTimestamp()) {
+            if ($vote->getTimestamp() === null) {
                 $errorMessage .= $countError > 0 ? ' ' : '';
                 $errorMessage .= 'The host variable wasn\'t set with "->setTimestamp(...)".';
             }
@@ -226,14 +226,14 @@ protected function checkVariablesForPackage(VoteInterface $vote)
                 $errorMessage .= 'The token variable wasn\'t set with "->setToken(...)".';
             }
 
-            throw new InvalidArgumentException($errorMessage);
+            throw new \InvalidArgumentException($errorMessage);
         }
     }
 
     /**
      * Verifies that the connection is correct.
      *
-     * @param string|null $header The header that the plugin usually sends
+     * @param null|string $header The header that the plugin usually sends
      *
      * @return bool returns true if connections is available, otherwise false
      */
@@ -241,9 +241,9 @@ protected function verifyConnectionHeader(?string $header): bool
     {
         $header_parts = explode(' ', $header);
         if (
-            null === $header
-            || false === mb_strpos($header, 'VOTIFIER')
-            || 3 !== count($header_parts)
+            $header === null
+            || mb_strpos($header, 'VOTIFIER') === false
+            || \count($header_parts) !== 3
         ) {
             return false;
         }
@@ -274,6 +274,6 @@ protected function preparePackageV2(VoteInterface $vote, string $challenge): str
         $messageJson = json_encode(['signature' => $signature, 'payload' => $payloadJson]);
 
         // 0x733a = s:
-        return pack('nn', 0x733a, mb_strlen($messageJson)) . $messageJson;
+        return pack('nn', 0x733A, mb_strlen($messageJson)).$messageJson;
     }
 }
diff --git a/src/Server/ServerInterface.php b/src/Server/ServerInterface.php
index 0c38161..81d8f9e 100644
--- a/src/Server/ServerInterface.php
+++ b/src/Server/ServerInterface.php
@@ -17,7 +17,6 @@
 use D3strukt0r\Votifier\Client\Exception\Socket\PackageNotReceivedException;
 use D3strukt0r\Votifier\Client\Exception\Socket\PackageNotSentException;
 use D3strukt0r\Votifier\Client\Vote\VoteInterface;
-use InvalidArgumentException;
 
 /**
  * The interface ServerInterface is used to define a PluginType on the server.
@@ -27,7 +26,7 @@ interface ServerInterface
     /**
      * Gets the host.
      *
-     * @return string|null returns the host
+     * @return null|string returns the host
      */
     public function getHost(): ?string;
 
@@ -59,7 +58,7 @@ public function setPort(int $port);
     /**
      * Gets the public key.
      *
-     * @return string|null returns the public key
+     * @return null|string returns the public key
      */
     public function getPublicKey(): ?string;
 
@@ -75,7 +74,7 @@ public function setPublicKey(string $publicKey);
     /**
      * Checks if the server actually belongs to Votifier.
      *
-     * @throws InvalidArgumentException    If one required parameter wasn't set
+     * @throws \InvalidArgumentException   If one required parameter wasn't set
      * @throws NoConnectionException       If connection couldn't be established
      * @throws PackageNotReceivedException If there was an error receiving the package
      * @throws NotVotifierException        If the server we are connected to is not a valid Votifier server
@@ -87,7 +86,7 @@ public function verifyConnection(): void;
      *
      * @param VoteInterface ...$votes The vote packages
      *
-     * @throws InvalidArgumentException    If one required parameter wasn't set
+     * @throws \InvalidArgumentException   If one required parameter wasn't set
      * @throws NoConnectionException       If connection couldn't be established
      * @throws PackageNotReceivedException If there was an error receiving the package
      * @throws PackageNotSentException     If there was an error sending the package
diff --git a/src/Server/Votifier.php b/src/Server/Votifier.php
index da1f566..d98d955 100644
--- a/src/Server/Votifier.php
+++ b/src/Server/Votifier.php
@@ -14,8 +14,6 @@
 
 use D3strukt0r\Votifier\Client\Exception\NotVotifierException;
 use D3strukt0r\Votifier\Client\Vote\VoteInterface;
-use DateTime;
-use InvalidArgumentException;
 
 /**
  * The Class to access a server which uses the classic "Votifier" plugin.
@@ -59,7 +57,7 @@ public function sendVote(VoteInterface ...$votes): void
             }
 
             // Update the timestamp of the vote being sent
-            $vote->setTimestamp(new DateTime());
+            $vote->setTimestamp(new \DateTime());
 
             // Check if all variables have been set, to create a package
             $this->checkVariablesForPackage($vote);
@@ -75,7 +73,7 @@ public function sendVote(VoteInterface ...$votes): void
     /**
      * Check that both host and port have been set.
      *
-     * @throws InvalidArgumentException If one required parameter wasn't set
+     * @throws \InvalidArgumentException If one required parameter wasn't set
      */
     protected function checkVariablesForSocket(): void
     {
@@ -83,7 +81,7 @@ protected function checkVariablesForSocket(): void
             // $countError = 0;
             $errorMessage = '';
 
-            if (null === $this->host) {
+            if ($this->host === null) {
                 $errorMessage .= 'The host variable wasn\'t set with "->setHost(...)".';
                 // ++$countError;
             }
@@ -93,7 +91,7 @@ protected function checkVariablesForSocket(): void
             //     $errorMessage .= 'The port variable wasn\'t set with "->setPort(...)".';
             // }
 
-            throw new InvalidArgumentException($errorMessage);
+            throw new \InvalidArgumentException($errorMessage);
         }
     }
 
@@ -102,35 +100,35 @@ protected function checkVariablesForSocket(): void
      *
      * @param VoteInterface $vote The vote to check
      *
-     * @throws InvalidArgumentException If one required parameter wasn't set
+     * @throws \InvalidArgumentException If one required parameter wasn't set
      */
-    protected function checkVariablesForPackage(VoteInterface $vote)
+    protected function checkVariablesForPackage(VoteInterface $vote): void
     {
         if (
-            null === $vote->getServiceName()
-            || null === $vote->getUsername()
-            || null === $vote->getAddress()
-            || null === $vote->getTimestamp()
+            $vote->getServiceName() === null
+            || $vote->getUsername() === null
+            || $vote->getAddress() === null
+            || $vote->getTimestamp() === null
             || !isset($this->publicKey)
         ) {
             $countError = 0;
             $errorMessage = '';
 
-            if (null === $vote->getServiceName()) {
+            if ($vote->getServiceName() === null) {
                 $errorMessage .= 'The host variable wasn\'t set with "->setServiceName(...)".';
                 ++$countError;
             }
-            if (null === $vote->getUsername()) {
+            if ($vote->getUsername() === null) {
                 $errorMessage .= $countError > 0 ? ' ' : '';
                 $errorMessage .= 'The host variable wasn\'t set with "->setUsername(...)".';
                 ++$countError;
             }
-            if (null === $vote->getAddress()) {
+            if ($vote->getAddress() === null) {
                 $errorMessage .= $countError > 0 ? ' ' : '';
                 $errorMessage .= 'The host variable wasn\'t set with "->setAddress(...)".';
                 ++$countError;
             }
-            if (null === $vote->getTimestamp()) {
+            if ($vote->getTimestamp() === null) {
                 $errorMessage .= $countError > 0 ? ' ' : '';
                 $errorMessage .= 'The host variable wasn\'t set with "->setTimestamp(...)".';
             }
@@ -139,7 +137,7 @@ protected function checkVariablesForPackage(VoteInterface $vote)
                 $errorMessage .= 'The public key variable wasn\'t set with "->setPublicKey(...)".';
             }
 
-            throw new InvalidArgumentException($errorMessage);
+            throw new \InvalidArgumentException($errorMessage);
         }
     }
 
@@ -147,15 +145,15 @@ protected function checkVariablesForPackage(VoteInterface $vote)
      * Verifies that the connection is correct. Read more:
      * https://github.com/vexsoftware/votifier/wiki/Protocol-Documentation.
      *
-     * @param string|null $header The header that the plugin usually sends
+     * @param null|string $header The header that the plugin usually sends
      *
      * @return bool returns true if connections is available, otherwise false
      */
     protected function verifyConnectionHeader(?string $header): bool
     {
         if (
-            null === $header
-            || false === mb_strpos($header, 'VOTIFIER')
+            $header === null
+            || mb_strpos($header, 'VOTIFIER') === false
         ) {
             return false;
         }
@@ -174,11 +172,11 @@ protected function verifyConnectionHeader(?string $header): bool
     protected function preparePackage(VoteInterface $vote): string
     {
         // Details of the vote
-        $votePackage = 'VOTE' . "\n" .
-            $vote->getServiceName() . "\n" .
-            $vote->getUsername() . "\n" .
-            $vote->getAddress() . "\n" .
-            $vote->getTimestamp() . "\n";
+        $votePackage = 'VOTE'."\n"
+            .$vote->getServiceName()."\n"
+            .$vote->getUsername()."\n"
+            .$vote->getAddress()."\n"
+            .$vote->getTimestamp()."\n";
 
         // Encrypt the string
         openssl_public_encrypt($votePackage, $encryptedVotePackage, $this->getPublicKey(), OPENSSL_SSLV23_PADDING);
diff --git a/src/Socket.php b/src/Socket.php
index c63edfe..e0ee2fb 100644
--- a/src/Socket.php
+++ b/src/Socket.php
@@ -33,7 +33,7 @@ class Socket
      */
     public function __destruct()
     {
-        if (is_resource($this->socket)) {
+        if (\is_resource($this->socket)) {
             fclose($this->socket);
         }
     }
@@ -49,7 +49,7 @@ public function __destruct()
     public function open(string $host, int $port): void
     {
         $socket = @fsockopen($host, $port, $errorNumber, $errorString, 3);
-        if (false === $socket) {
+        if ($socket === false) {
             throw new NoConnectionException($errorString, $errorNumber);
         }
         $this->socket = $socket;
@@ -65,11 +65,11 @@ public function open(string $host, int $port): void
      */
     public function write(string $string): void
     {
-        if (!is_resource($this->socket)) {
+        if (!\is_resource($this->socket)) {
             throw new NoConnectionException();
         }
 
-        if (false === fwrite($this->socket, $string)) {
+        if (fwrite($this->socket, $string) === false) {
             throw new PackageNotSentException();
         }
     }
@@ -79,14 +79,14 @@ public function write(string $string): void
      *
      * @param int $length [optional] The length of the requested string
      *
+     * @return string returns the string received from the server
+     *
      * @throws NoConnectionException       If connection has not been set up
      * @throws PackageNotReceivedException If there was an error receiving the package
-     *
-     * @return string returns the string received from the server
      */
     public function read(int $length = 64): string
     {
-        if (!is_resource($this->socket)) {
+        if (!\is_resource($this->socket)) {
             throw new NoConnectionException();
         }
 
diff --git a/src/Vote/ClassicVote.php b/src/Vote/ClassicVote.php
index d9fa426..b5f6807 100644
--- a/src/Vote/ClassicVote.php
+++ b/src/Vote/ClassicVote.php
@@ -12,8 +12,6 @@
 
 namespace D3strukt0r\Votifier\Client\Vote;
 
-use DateTime;
-
 /**
  * The classic vote package can be used by most plugins.
  */
@@ -35,7 +33,7 @@ class ClassicVote implements VoteInterface
     protected $address;
 
     /**
-     * @var DateTime the time when the vote will be sent
+     * @var \DateTime the time when the vote will be sent
      */
     protected $timestamp;
 
@@ -105,9 +103,9 @@ public function getTimestamp(): ?int
     /**
      * {@inheritdoc}
      */
-    public function setTimestamp(DateTime $timestamp = null): self
+    public function setTimestamp(?\DateTime $timestamp = null): self
     {
-        $this->timestamp = $timestamp ?: new DateTime();
+        $this->timestamp = $timestamp ?: new \DateTime();
 
         return $this;
     }
diff --git a/src/Vote/VoteInterface.php b/src/Vote/VoteInterface.php
index d49be06..43c3183 100644
--- a/src/Vote/VoteInterface.php
+++ b/src/Vote/VoteInterface.php
@@ -12,8 +12,6 @@
 
 namespace D3strukt0r\Votifier\Client\Vote;
 
-use DateTime;
-
 /**
  * The interface VoteInterface will be used for different kinds of vote packages.
  */
@@ -22,7 +20,7 @@ interface VoteInterface
     /**
      * Gets the name of the list/service.
      *
-     * @return string|null returns the name of the list/service
+     * @return null|string returns the name of the list/service
      */
     public function getServiceName(): ?string;
 
@@ -38,7 +36,7 @@ public function setServiceName(string $serviceName);
     /**
      * Gets the username of the user who wants to receive the rewards.
      *
-     * @return string|null returns the username who wants to receive the rewards
+     * @return null|string returns the username who wants to receive the rewards
      */
     public function getUsername(): ?string;
 
@@ -54,7 +52,7 @@ public function setUsername(string $username);
     /**
      * Gets the IP Address of the user.
      *
-     * @return string|null returns the IP Address of the user
+     * @return null|string returns the IP Address of the user
      */
     public function getAddress(): ?string;
 
@@ -70,16 +68,16 @@ public function setAddress(string $address);
     /**
      * Gets the time when the vote was sent.
      *
-     * @return int|null returns the time when the vote was sent, null otherwise
+     * @return null|int returns the time when the vote was sent, null otherwise
      */
     public function getTimestamp(): ?int;
 
     /**
      * Sets the time when the vote will be sent.
      *
-     * @param DateTime|null $timestamp [optional] Either give a wanted timestamp or it will use the current time
+     * @param null|\DateTime $timestamp [optional] Either give a wanted timestamp or it will use the current time
      *
      * @return $this returns the class itself, for doing multiple things at once
      */
-    public function setTimestamp(DateTime $timestamp = null);
+    public function setTimestamp(?\DateTime $timestamp = null);
 }

From ef4600b3b84585c6ac5d3605e57122e1ca253ab6 Mon Sep 17 00:00:00 2001
From: D3strukt0r <dev@d3strukt0r.dev>
Date: Mon, 29 Jun 2026 22:05:00 +0200
Subject: [PATCH 02/13] fix: encrypt classic Votifier packets with PKCS#1 v1.5
 padding

Classic Votifier encryption used OPENSSL_SSLV23_PADDING, a constant OpenSSL 3.0 removed and that is undefined on PHP 8, so encryption failed on modern stacks. Encrypt with openssl_public_encrypt's default PKCS#1 v1.5 padding instead, which is exactly what Votifier decrypts with (Cipher.getInstance("RSA") resolves to PKCS#1 v1.5 via the JDK's SunJCE provider).

The public key is now parsed with openssl_pkey_get_public up front, so an invalid key throws an InvalidArgumentException instead of silently producing an empty packet, and the PEM body is wrapped at 64 characters.
---
 src/Server/GenericServer.php |  2 +-
 src/Server/Votifier.php      | 14 ++++++++++++--
 2 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/src/Server/GenericServer.php b/src/Server/GenericServer.php
index 7e66e54..c3a722e 100644
--- a/src/Server/GenericServer.php
+++ b/src/Server/GenericServer.php
@@ -112,7 +112,7 @@ public function getPublicKey(): ?string
      */
     public function setPublicKey(string $publicKey): self
     {
-        $publicKey = wordwrap($publicKey, 65, "\n", true);
+        $publicKey = wordwrap($publicKey, 64, "\n", true);
         $publicKey = <<<EOF
 -----BEGIN PUBLIC KEY-----
 {$publicKey}
diff --git a/src/Server/Votifier.php b/src/Server/Votifier.php
index d98d955..3e2bb19 100644
--- a/src/Server/Votifier.php
+++ b/src/Server/Votifier.php
@@ -178,8 +178,18 @@ protected function preparePackage(VoteInterface $vote): string
             .$vote->getAddress()."\n"
             .$vote->getTimestamp()."\n";
 
-        // Encrypt the string
-        openssl_public_encrypt($votePackage, $encryptedVotePackage, $this->getPublicKey(), OPENSSL_SSLV23_PADDING);
+        // Parse the PEM public key up front so an invalid key fails loudly here
+        // instead of openssl_public_encrypt() silently producing an empty packet.
+        $publicKey = openssl_pkey_get_public($this->getPublicKey());
+        if ($publicKey === false) {
+            throw new \InvalidArgumentException('The public key set with "->setPublicKey(...)" is not a valid RSA public key.');
+        }
+
+        // Encrypt with openssl_public_encrypt's default PKCS#1 v1.5 padding, which is
+        // what Votifier decrypts with (Cipher.getInstance("RSA") resolves to PKCS#1
+        // v1.5 via the JDK's default SunJCE provider). The old explicit
+        // OPENSSL_SSLV23_PADDING was removed in OpenSSL 3.0 and is undefined on PHP 8.x.
+        openssl_public_encrypt($votePackage, $encryptedVotePackage, $publicKey);
 
         return $encryptedVotePackage;
     }

From 95bd6ddc8179cca1c21d2ebd8b3d13cf2011d744 Mon Sep 17 00:00:00 2001
From: D3strukt0r <dev@d3strukt0r.dev>
Date: Mon, 29 Jun 2026 22:10:00 +0200
Subject: [PATCH 03/13] fix: support PHP 7.1 through 8.5

Replace the deprecated call_user_func_array([$this, 'parent::sendVote'], ...) parent-call form, which no longer works as a callable on newer PHP, with parent::sendVote(...$votes).
---
 src/Server/NuVotifier.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Server/NuVotifier.php b/src/Server/NuVotifier.php
index 0ec30cc..4b975d6 100644
--- a/src/Server/NuVotifier.php
+++ b/src/Server/NuVotifier.php
@@ -114,7 +114,7 @@ public function verifyConnection(): void
     public function sendVote(VoteInterface ...$votes): void
     {
         if (!$this->isProtocolV2()) {
-            call_user_func_array([$this, 'parent::sendVote'], func_get_args());
+            parent::sendVote(...$votes);
 
             return;
         }

From 27bbfb88ec3a63459c6f1a73cdce74d690996f1b Mon Sep 17 00:00:00 2001
From: D3strukt0r <dev@d3strukt0r.dev>
Date: Mon, 29 Jun 2026 22:15:00 +0200
Subject: [PATCH 04/13] fix: time out and report when a server sends no
 response

fsockopen only set a connect timeout, so the first read blocked for php.ini's default_socket_timeout (60s) before failing with the vague "package not received". Set an explicit read timeout via stream_set_timeout and, when a read times out, throw a PackageNotReceivedException explaining that the server accepted the connection but sent nothing and that the host and Votifier port (default 8192, not the Minecraft port 25565) should be checked.

Closes #5
---
 src/Socket.php | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/src/Socket.php b/src/Socket.php
index e0ee2fb..245db1f 100644
--- a/src/Socket.php
+++ b/src/Socket.php
@@ -23,6 +23,19 @@
  */
 class Socket
 {
+    /**
+     * @var int Seconds to wait for the TCP connection to be established
+     */
+    private const CONNECT_TIMEOUT = 3;
+
+    /**
+     * @var int Seconds to wait for a response (the greeting and the NuVotifier v2
+     *          reply). Generous enough that a slow or distant server doesn't trip a
+     *          false timeout, but far below PHP's 60s default_socket_timeout, which
+     *          previously made an unresponsive endpoint hang for a full minute.
+     */
+    private const READ_TIMEOUT = 10;
+
     /**
      * @var resource the connection to the server
      */
@@ -48,10 +61,13 @@ public function __destruct()
      */
     public function open(string $host, int $port): void
     {
-        $socket = @fsockopen($host, $port, $errorNumber, $errorString, 3);
+        $socket = @fsockopen($host, $port, $errorNumber, $errorString, self::CONNECT_TIMEOUT);
         if ($socket === false) {
             throw new NoConnectionException($errorString, $errorNumber);
         }
+        // Cap the wait for a response; otherwise reads block for php.ini's
+        // default_socket_timeout (60s) before failing.
+        stream_set_timeout($socket, self::READ_TIMEOUT);
         $this->socket = $socket;
     }
 
@@ -91,6 +107,10 @@ public function read(int $length = 64): string
         }
 
         if (!$string = fread($this->socket, $length)) {
+            if (stream_get_meta_data($this->socket)['timed_out']) {
+                throw new PackageNotReceivedException('The server accepted the connection but did not respond within '.self::READ_TIMEOUT.' seconds. Check that the host and the Votifier port (default 8192, not the Minecraft port 25565) are correct and reachable.');
+            }
+
             throw new PackageNotReceivedException();
         }
 

From 4aee88d73c6e95c7303edd9cffbbc8a13810249e Mon Sep 17 00:00:00 2001
From: D3strukt0r <dev@d3strukt0r.dev>
Date: Mon, 29 Jun 2026 22:20:00 +0200
Subject: [PATCH 05/13] fix: include the underlying reason and host when a
 connection can't be opened

When fsockopen fails, the OS-level reason (connection refused, timed out, no route to host, DNS failure) was discarded and the caller only saw a generic "could not create a connection". Surface that reason, along with the host and port, in the NoConnectionException message so the cause is visible.

Closes #4
---
 src/Socket.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Socket.php b/src/Socket.php
index 245db1f..79bcbce 100644
--- a/src/Socket.php
+++ b/src/Socket.php
@@ -63,7 +63,7 @@ public function open(string $host, int $port): void
     {
         $socket = @fsockopen($host, $port, $errorNumber, $errorString, self::CONNECT_TIMEOUT);
         if ($socket === false) {
-            throw new NoConnectionException($errorString, $errorNumber);
+            throw new NoConnectionException(\sprintf('Could not connect to %s:%d (%s). Make sure the Votifier port (default 8192, not the Minecraft port 25565) is open and reachable from this host.', $host, $port, $errorString !== '' ? $errorString : 'unknown error'), $errorNumber);
         }
         // Cap the wait for a response; otherwise reads block for php.ini's
         // default_socket_timeout (60s) before failing.

From 919905fc307289b0a20fdef1e39f84d62c90a019 Mon Sep 17 00:00:00 2001
From: D3strukt0r <dev@d3strukt0r.dev>
Date: Mon, 29 Jun 2026 22:25:00 +0200
Subject: [PATCH 06/13] docs: overhaul the Sphinx documentation

Generate the CC BY-NC-SA license page from the official source, pull the community-health files from the Team-MaRo/.github submodule instead of duplicating them, and drop the committed phpDocumentor API dump.
---
 .gitmodules                                   |   3 +
 .readthedocs.yml                              |  20 +-
 docs/LICENSE.txt                              | 437 ++++++++++++++++++
 docs/requirements.txt                         |   2 +
 docs/source/_community                        |   1 +
 docs/source/_static/.gitignore                |   0
 docs/source/_static/css/custom.css            |   7 +-
 docs/source/_templates/.gitignore             |   0
 .../api/Exception/NotVotifierException.rst    |   8 -
 .../NuVotifierChallengeInvalidException.rst   |   8 -
 .../api/Exception/NuVotifierException.rst     |   8 -
 .../NuVotifierSignatureInvalidException.rst   |   8 -
 .../NuVotifierUnknownServiceException.rst     |   8 -
 .../NuVotifierUsernameTooLongException.rst    |   8 -
 .../Socket/NoConnectionException.rst          |   8 -
 .../Socket/PackageNotReceivedException.rst    |   8 -
 .../Socket/PackageNotSentException.rst        |   8 -
 docs/source/api/Exception/Socket/index.rst    |  14 -
 docs/source/api/Exception/index.rst           |  24 -
 docs/source/api/Server/GenericServer.rst      |  82 ----
 docs/source/api/Server/NuVotifier.rst         | 219 ---------
 docs/source/api/Server/ServerInterface.rst    |  98 ----
 docs/source/api/Server/Votifier.rst           | 158 -------
 docs/source/api/Server/index.rst              |  21 -
 docs/source/api/Socket.rst                    |  47 --
 docs/source/api/Vote/ClassicVote.rst          |  82 ----
 docs/source/api/Vote/VoteInterface.rst        |  66 ---
 docs/source/api/Vote/index.rst                |  13 -
 docs/source/api/index.rst                     |  25 +-
 docs/source/appendix/changelog.rst            |  62 +--
 docs/source/appendix/code-of-conduct.rst      |  54 +--
 docs/source/appendix/contributing.rst         |  33 +-
 .../contributing/code-style-guidelines.rst    |  33 --
 .../contributing/pull-request-workflow.rst    |   8 -
 .../contributing/ways-to-contribute.rst       |   7 -
 docs/source/appendix/copyright.rst            | 160 +------
 docs/source/appendix/faq.rst                  |   5 -
 docs/source/appendix/sponsors.rst             |   5 -
 docs/source/conf.py                           |  35 +-
 docs/source/getting-started/prerequisites.rst |  16 +-
 docs/source/getting-started/votifier.rst      |  10 +
 docs/source/index.rst                         |   4 +-
 docs/update-license.py                        | 276 +++++++++++
 phpdoc.dist.xml                               |   6 +-
 44 files changed, 851 insertions(+), 1254 deletions(-)
 create mode 100644 .gitmodules
 create mode 100644 docs/LICENSE.txt
 create mode 160000 docs/source/_community
 delete mode 100644 docs/source/_static/.gitignore
 delete mode 100644 docs/source/_templates/.gitignore
 delete mode 100644 docs/source/api/Exception/NotVotifierException.rst
 delete mode 100644 docs/source/api/Exception/NuVotifierChallengeInvalidException.rst
 delete mode 100644 docs/source/api/Exception/NuVotifierException.rst
 delete mode 100644 docs/source/api/Exception/NuVotifierSignatureInvalidException.rst
 delete mode 100644 docs/source/api/Exception/NuVotifierUnknownServiceException.rst
 delete mode 100644 docs/source/api/Exception/NuVotifierUsernameTooLongException.rst
 delete mode 100644 docs/source/api/Exception/Socket/NoConnectionException.rst
 delete mode 100644 docs/source/api/Exception/Socket/PackageNotReceivedException.rst
 delete mode 100644 docs/source/api/Exception/Socket/PackageNotSentException.rst
 delete mode 100644 docs/source/api/Exception/Socket/index.rst
 delete mode 100644 docs/source/api/Exception/index.rst
 delete mode 100644 docs/source/api/Server/GenericServer.rst
 delete mode 100644 docs/source/api/Server/NuVotifier.rst
 delete mode 100644 docs/source/api/Server/ServerInterface.rst
 delete mode 100644 docs/source/api/Server/Votifier.rst
 delete mode 100644 docs/source/api/Server/index.rst
 delete mode 100644 docs/source/api/Socket.rst
 delete mode 100644 docs/source/api/Vote/ClassicVote.rst
 delete mode 100644 docs/source/api/Vote/VoteInterface.rst
 delete mode 100644 docs/source/api/Vote/index.rst
 delete mode 100644 docs/source/appendix/contributing/code-style-guidelines.rst
 delete mode 100644 docs/source/appendix/contributing/pull-request-workflow.rst
 delete mode 100644 docs/source/appendix/contributing/ways-to-contribute.rst
 delete mode 100644 docs/source/appendix/faq.rst
 delete mode 100644 docs/source/appendix/sponsors.rst
 create mode 100755 docs/update-license.py

diff --git a/.gitmodules b/.gitmodules
new file mode 100644
index 0000000..d40c984
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,3 @@
+[submodule "docs/source/_community"]
+	path = docs/source/_community
+	url = https://github.com/Team-MaRo/.github.git
diff --git a/.readthedocs.yml b/.readthedocs.yml
index 1ddcede..ceb7c45 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -4,6 +4,17 @@
 # Required
 version: 2
 
+# Set the build environment (build.os and build.tools are now required)
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "latest"
+  jobs:
+    pre_build:
+      # Generate the formatted Markdown license (docs/LICENSE.md) from the
+      # official legalcode; the plain-text original lives at docs/LICENSE.txt.
+      - python docs/update-license.py
+
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
   configuration: docs/source/conf.py
@@ -11,8 +22,13 @@ sphinx:
 # Optionally build your docs in additional formats such as PDF and ePub
 formats: all
 
-# Optionally set the version of Python and requirements required to build your docs
+# Install the Python requirements needed to build the docs
 python:
-  version: 3.7
   install:
     - requirements: docs/requirements.txt
+
+# Pull in the shared community-health files (Code of Conduct, Contributing)
+# from the central Team-MaRo/.github repo so they are not duplicated here.
+submodules:
+  include:
+    - docs/source/_community
diff --git a/docs/LICENSE.txt b/docs/LICENSE.txt
new file mode 100644
index 0000000..cbe5ad1
--- /dev/null
+++ b/docs/LICENSE.txt
@@ -0,0 +1,437 @@
+Attribution-NonCommercial-ShareAlike 4.0 International
+
+=======================================================================
+
+Creative Commons Corporation ("Creative Commons") is not a law firm and
+does not provide legal services or legal advice. Distribution of
+Creative Commons public licenses does not create a lawyer-client or
+other relationship. Creative Commons makes its licenses and related
+information available on an "as-is" basis. Creative Commons gives no
+warranties regarding its licenses, any material licensed under their
+terms and conditions, or any related information. Creative Commons
+disclaims all liability for damages resulting from their use to the
+fullest extent possible.
+
+Using Creative Commons Public Licenses
+
+Creative Commons public licenses provide a standard set of terms and
+conditions that creators and other rights holders may use to share
+original works of authorship and other material subject to copyright
+and certain other rights specified in the public license below. The
+following considerations are for informational purposes only, are not
+exhaustive, and do not form part of our licenses.
+
+     Considerations for licensors: Our public licenses are
+     intended for use by those authorized to give the public
+     permission to use material in ways otherwise restricted by
+     copyright and certain other rights. Our licenses are
+     irrevocable. Licensors should read and understand the terms
+     and conditions of the license they choose before applying it.
+     Licensors should also secure all rights necessary before
+     applying our licenses so that the public can reuse the
+     material as expected. Licensors should clearly mark any
+     material not subject to the license. This includes other CC-
+     licensed material, or material used under an exception or
+     limitation to copyright. More considerations for licensors:
+    wiki.creativecommons.org/Considerations_for_licensors
+
+     Considerations for the public: By using one of our public
+     licenses, a licensor grants the public permission to use the
+     licensed material under specified terms and conditions. If
+     the licensor's permission is not necessary for any reason--for
+     example, because of any applicable exception or limitation to
+     copyright--then that use is not regulated by the license. Our
+     licenses grant only permissions under copyright and certain
+     other rights that a licensor has authority to grant. Use of
+     the licensed material may still be restricted for other
+     reasons, including because others have copyright or other
+     rights in the material. A licensor may make special requests,
+     such as asking that all changes be marked or described.
+     Although not required by our licenses, you are encouraged to
+     respect those requests where reasonable. More considerations
+     for the public:
+    wiki.creativecommons.org/Considerations_for_licensees
+
+=======================================================================
+
+Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International
+Public License
+
+By exercising the Licensed Rights (defined below), You accept and agree
+to be bound by the terms and conditions of this Creative Commons
+Attribution-NonCommercial-ShareAlike 4.0 International Public License
+("Public License"). To the extent this Public License may be
+interpreted as a contract, You are granted the Licensed Rights in
+consideration of Your acceptance of these terms and conditions, and the
+Licensor grants You such rights in consideration of benefits the
+Licensor receives from making the Licensed Material available under
+these terms and conditions.
+
+
+Section 1 -- Definitions.
+
+  a. Adapted Material means material subject to Copyright and Similar
+     Rights that is derived from or based upon the Licensed Material
+     and in which the Licensed Material is translated, altered,
+     arranged, transformed, or otherwise modified in a manner requiring
+     permission under the Copyright and Similar Rights held by the
+     Licensor. For purposes of this Public License, where the Licensed
+     Material is a musical work, performance, or sound recording,
+     Adapted Material is always produced where the Licensed Material is
+     synched in timed relation with a moving image.
+
+  b. Adapter's License means the license You apply to Your Copyright
+     and Similar Rights in Your contributions to Adapted Material in
+     accordance with the terms and conditions of this Public License.
+
+  c. BY-NC-SA Compatible License means a license listed at
+     creativecommons.org/compatiblelicenses, approved by Creative
+     Commons as essentially the equivalent of this Public License.
+
+  d. Copyright and Similar Rights means copyright and/or similar rights
+     closely related to copyright including, without limitation,
+     performance, broadcast, sound recording, and Sui Generis Database
+     Rights, without regard to how the rights are labeled or
+     categorized. For purposes of this Public License, the rights
+     specified in Section 2(b)(1)-(2) are not Copyright and Similar
+     Rights.
+
+  e. Effective Technological Measures means those measures that, in the
+     absence of proper authority, may not be circumvented under laws
+     fulfilling obligations under Article 11 of the WIPO Copyright
+     Treaty adopted on December 20, 1996, and/or similar international
+     agreements.
+
+  f. Exceptions and Limitations means fair use, fair dealing, and/or
+     any other exception or limitation to Copyright and Similar Rights
+     that applies to Your use of the Licensed Material.
+
+  g. License Elements means the license attributes listed in the name
+     of a Creative Commons Public License. The License Elements of this
+     Public License are Attribution, NonCommercial, and ShareAlike.
+
+  h. Licensed Material means the artistic or literary work, database,
+     or other material to which the Licensor applied this Public
+     License.
+
+  i. Licensed Rights means the rights granted to You subject to the
+     terms and conditions of this Public License, which are limited to
+     all Copyright and Similar Rights that apply to Your use of the
+     Licensed Material and that the Licensor has authority to license.
+
+  j. Licensor means the individual(s) or entity(ies) granting rights
+     under this Public License.
+
+  k. NonCommercial means not primarily intended for or directed towards
+     commercial advantage or monetary compensation. For purposes of
+     this Public License, the exchange of the Licensed Material for
+     other material subject to Copyright and Similar Rights by digital
+     file-sharing or similar means is NonCommercial provided there is
+     no payment of monetary compensation in connection with the
+     exchange.
+
+  l. Share means to provide material to the public by any means or
+     process that requires permission under the Licensed Rights, such
+     as reproduction, public display, public performance, distribution,
+     dissemination, communication, or importation, and to make material
+     available to the public including in ways that members of the
+     public may access the material from a place and at a time
+     individually chosen by them.
+
+  m. Sui Generis Database Rights means rights other than copyright
+     resulting from Directive 96/9/EC of the European Parliament and of
+     the Council of 11 March 1996 on the legal protection of databases,
+     as amended and/or succeeded, as well as other essentially
+     equivalent rights anywhere in the world.
+
+  n. You means the individual or entity exercising the Licensed Rights
+     under this Public License. Your has a corresponding meaning.
+
+
+Section 2 -- Scope.
+
+  a. License grant.
+
+       1. Subject to the terms and conditions of this Public License,
+          the Licensor hereby grants You a worldwide, royalty-free,
+          non-sublicensable, non-exclusive, irrevocable license to
+          exercise the Licensed Rights in the Licensed Material to:
+
+            a. reproduce and Share the Licensed Material, in whole or
+               in part, for NonCommercial purposes only; and
+
+            b. produce, reproduce, and Share Adapted Material for
+               NonCommercial purposes only.
+
+       2. Exceptions and Limitations. For the avoidance of doubt, where
+          Exceptions and Limitations apply to Your use, this Public
+          License does not apply, and You do not need to comply with
+          its terms and conditions.
+
+       3. Term. The term of this Public License is specified in Section
+          6(a).
+
+       4. Media and formats; technical modifications allowed. The
+          Licensor authorizes You to exercise the Licensed Rights in
+          all media and formats whether now known or hereafter created,
+          and to make technical modifications necessary to do so. The
+          Licensor waives and/or agrees not to assert any right or
+          authority to forbid You from making technical modifications
+          necessary to exercise the Licensed Rights, including
+          technical modifications necessary to circumvent Effective
+          Technological Measures. For purposes of this Public License,
+          simply making modifications authorized by this Section 2(a)
+          (4) never produces Adapted Material.
+
+       5. Downstream recipients.
+
+            a. Offer from the Licensor -- Licensed Material. Every
+               recipient of the Licensed Material automatically
+               receives an offer from the Licensor to exercise the
+               Licensed Rights under the terms and conditions of this
+               Public License.
+
+            b. Additional offer from the Licensor -- Adapted Material.
+               Every recipient of Adapted Material from You
+               automatically receives an offer from the Licensor to
+               exercise the Licensed Rights in the Adapted Material
+               under the conditions of the Adapter's License You apply.
+
+            c. No downstream restrictions. You may not offer or impose
+               any additional or different terms or conditions on, or
+               apply any Effective Technological Measures to, the
+               Licensed Material if doing so restricts exercise of the
+               Licensed Rights by any recipient of the Licensed
+               Material.
+
+       6. No endorsement. Nothing in this Public License constitutes or
+          may be construed as permission to assert or imply that You
+          are, or that Your use of the Licensed Material is, connected
+          with, or sponsored, endorsed, or granted official status by,
+          the Licensor or others designated to receive attribution as
+          provided in Section 3(a)(1)(A)(i).
+
+  b. Other rights.
+
+       1. Moral rights, such as the right of integrity, are not
+          licensed under this Public License, nor are publicity,
+          privacy, and/or other similar personality rights; however, to
+          the extent possible, the Licensor waives and/or agrees not to
+          assert any such rights held by the Licensor to the limited
+          extent necessary to allow You to exercise the Licensed
+          Rights, but not otherwise.
+
+       2. Patent and trademark rights are not licensed under this
+          Public License.
+
+       3. To the extent possible, the Licensor waives any right to
+          collect royalties from You for the exercise of the Licensed
+          Rights, whether directly or through a collecting society
+          under any voluntary or waivable statutory or compulsory
+          licensing scheme. In all other cases the Licensor expressly
+          reserves any right to collect such royalties, including when
+          the Licensed Material is used other than for NonCommercial
+          purposes.
+
+
+Section 3 -- License Conditions.
+
+Your exercise of the Licensed Rights is expressly made subject to the
+following conditions.
+
+  a. Attribution.
+
+       1. If You Share the Licensed Material (including in modified
+          form), You must:
+
+            a. retain the following if it is supplied by the Licensor
+               with the Licensed Material:
+
+                 i. identification of the creator(s) of the Licensed
+                    Material and any others designated to receive
+                    attribution, in any reasonable manner requested by
+                    the Licensor (including by pseudonym if
+                    designated);
+
+                ii. a copyright notice;
+
+               iii. a notice that refers to this Public License;
+
+                iv. a notice that refers to the disclaimer of
+                    warranties;
+
+                 v. a URI or hyperlink to the Licensed Material to the
+                    extent reasonably practicable;
+
+            b. indicate if You modified the Licensed Material and
+               retain an indication of any previous modifications; and
+
+            c. indicate the Licensed Material is licensed under this
+               Public License, and include the text of, or the URI or
+               hyperlink to, this Public License.
+
+       2. You may satisfy the conditions in Section 3(a)(1) in any
+          reasonable manner based on the medium, means, and context in
+          which You Share the Licensed Material. For example, it may be
+          reasonable to satisfy the conditions by providing a URI or
+          hyperlink to a resource that includes the required
+          information.
+       3. If requested by the Licensor, You must remove any of the
+          information required by Section 3(a)(1)(A) to the extent
+          reasonably practicable.
+
+  b. ShareAlike.
+
+     In addition to the conditions in Section 3(a), if You Share
+     Adapted Material You produce, the following conditions also apply.
+
+       1. The Adapter's License You apply must be a Creative Commons
+          license with the same License Elements, this version or
+          later, or a BY-NC-SA Compatible License.
+
+       2. You must include the text of, or the URI or hyperlink to, the
+          Adapter's License You apply. You may satisfy this condition
+          in any reasonable manner based on the medium, means, and
+          context in which You Share Adapted Material.
+
+       3. You may not offer or impose any additional or different terms
+          or conditions on, or apply any Effective Technological
+          Measures to, Adapted Material that restrict exercise of the
+          rights granted under the Adapter's License You apply.
+
+
+Section 4 -- Sui Generis Database Rights.
+
+Where the Licensed Rights include Sui Generis Database Rights that
+apply to Your use of the Licensed Material:
+
+  a. for the avoidance of doubt, Section 2(a)(1) grants You the right
+     to extract, reuse, reproduce, and Share all or a substantial
+     portion of the contents of the database for NonCommercial purposes
+     only;
+
+  b. if You include all or a substantial portion of the database
+     contents in a database in which You have Sui Generis Database
+     Rights, then the database in which You have Sui Generis Database
+     Rights (but not its individual contents) is Adapted Material,
+     including for purposes of Section 3(b); and
+
+  c. You must comply with the conditions in Section 3(a) if You Share
+     all or a substantial portion of the contents of the database.
+
+For the avoidance of doubt, this Section 4 supplements and does not
+replace Your obligations under this Public License where the Licensed
+Rights include other Copyright and Similar Rights.
+
+
+Section 5 -- Disclaimer of Warranties and Limitation of Liability.
+
+  a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
+     EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
+     AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
+     ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
+     IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
+     WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
+     PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
+     ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
+     KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
+     ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
+
+  b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
+     TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
+     NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
+     INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
+     COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
+     USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
+     ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
+     DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
+     IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
+
+  c. The disclaimer of warranties and limitation of liability provided
+     above shall be interpreted in a manner that, to the extent
+     possible, most closely approximates an absolute disclaimer and
+     waiver of all liability.
+
+
+Section 6 -- Term and Termination.
+
+  a. This Public License applies for the term of the Copyright and
+     Similar Rights licensed here. However, if You fail to comply with
+     this Public License, then Your rights under this Public License
+     terminate automatically.
+
+  b. Where Your right to use the Licensed Material has terminated under
+     Section 6(a), it reinstates:
+
+       1. automatically as of the date the violation is cured, provided
+          it is cured within 30 days of Your discovery of the
+          violation; or
+
+       2. upon express reinstatement by the Licensor.
+
+     For the avoidance of doubt, this Section 6(b) does not affect any
+     right the Licensor may have to seek remedies for Your violations
+     of this Public License.
+
+  c. For the avoidance of doubt, the Licensor may also offer the
+     Licensed Material under separate terms or conditions or stop
+     distributing the Licensed Material at any time; however, doing so
+     will not terminate this Public License.
+
+  d. Sections 1, 5, 6, 7, and 8 survive termination of this Public
+     License.
+
+
+Section 7 -- Other Terms and Conditions.
+
+  a. The Licensor shall not be bound by any additional or different
+     terms or conditions communicated by You unless expressly agreed.
+
+  b. Any arrangements, understandings, or agreements regarding the
+     Licensed Material not stated herein are separate from and
+     independent of the terms and conditions of this Public License.
+
+
+Section 8 -- Interpretation.
+
+  a. For the avoidance of doubt, this Public License does not, and
+     shall not be interpreted to, reduce, limit, restrict, or impose
+     conditions on any use of the Licensed Material that could lawfully
+     be made without permission under this Public License.
+
+  b. To the extent possible, if any provision of this Public License is
+     deemed unenforceable, it shall be automatically reformed to the
+     minimum extent necessary to make it enforceable. If the provision
+     cannot be reformed, it shall be severed from this Public License
+     without affecting the enforceability of the remaining terms and
+     conditions.
+
+  c. No term or condition of this Public License will be waived and no
+     failure to comply consented to unless expressly agreed to by the
+     Licensor.
+
+  d. Nothing in this Public License constitutes or may be interpreted
+     as a limitation upon, or waiver of, any privileges and immunities
+     that apply to the Licensor or You, including from the legal
+     processes of any jurisdiction or authority.
+
+=======================================================================
+
+Creative Commons is not a party to its public
+licenses. Notwithstanding, Creative Commons may elect to apply one of
+its public licenses to material it publishes and in those instances
+will be considered the “Licensor.” The text of the Creative Commons
+public licenses is dedicated to the public domain under the CC0 Public
+Domain Dedication. Except for the limited purpose of indicating that
+material is shared under a Creative Commons public license or as
+otherwise permitted by the Creative Commons policies published at
+creativecommons.org/policies, Creative Commons does not authorize the
+use of the trademark "Creative Commons" or any other trademark or logo
+of Creative Commons without its prior written consent including,
+without limitation, in connection with any unauthorized modifications
+to any of its public licenses or any other arrangements,
+understandings, or agreements concerning use of licensed material. For
+the avoidance of doubt, this paragraph does not form part of the
+public licenses.
+
+Creative Commons may be contacted at creativecommons.org.
diff --git a/docs/requirements.txt b/docs/requirements.txt
index 4c35754..d8956d2 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,2 +1,4 @@
 sphinx_rtd_theme
 sphinxcontrib-phpdomain
+myst-parser
+beautifulsoup4
diff --git a/docs/source/_community b/docs/source/_community
new file mode 160000
index 0000000..a00dd75
--- /dev/null
+++ b/docs/source/_community
@@ -0,0 +1 @@
+Subproject commit a00dd75bbac7e43135f598be9706dafaa54471d1
diff --git a/docs/source/_static/.gitignore b/docs/source/_static/.gitignore
deleted file mode 100644
index e69de29..0000000
diff --git a/docs/source/_static/css/custom.css b/docs/source/_static/css/custom.css
index 7d393f5..e177ff0 100644
--- a/docs/source/_static/css/custom.css
+++ b/docs/source/_static/css/custom.css
@@ -1,8 +1,5 @@
-.bold-italic {
-    font-weight: bold;
-    font-style: italic;
-}
-
+/* The generated license (docs/LICENSE.rst) marks defined terms with the
+   reStructuredText :underline: role, which docutils renders as this class. */
 .underline {
     text-decoration: underline;
 }
diff --git a/docs/source/_templates/.gitignore b/docs/source/_templates/.gitignore
deleted file mode 100644
index e69de29..0000000
diff --git a/docs/source/api/Exception/NotVotifierException.rst b/docs/source/api/Exception/NotVotifierException.rst
deleted file mode 100644
index e7e145e..0000000
--- a/docs/source/api/Exception/NotVotifierException.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client\\Exception**
-
-====================
-NotVotifierException
-====================
-
-.. php:namespace:: D3strukt0r\Votifier\Client\Exception
-.. php:exception:: NotVotifierException
diff --git a/docs/source/api/Exception/NuVotifierChallengeInvalidException.rst b/docs/source/api/Exception/NuVotifierChallengeInvalidException.rst
deleted file mode 100644
index c6917c5..0000000
--- a/docs/source/api/Exception/NuVotifierChallengeInvalidException.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client\\Exception**
-
-===================================
-NuVotifierChallengeInvalidException
-===================================
-
-.. php:namespace:: D3strukt0r\Votifier\Client\Exception
-.. php:exception:: NuVotifierChallengeInvalidException
diff --git a/docs/source/api/Exception/NuVotifierException.rst b/docs/source/api/Exception/NuVotifierException.rst
deleted file mode 100644
index bc0b8ee..0000000
--- a/docs/source/api/Exception/NuVotifierException.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client\\Exception**
-
-===================
-NuVotifierException
-===================
-
-.. php:namespace:: D3strukt0r\Votifier\Client\Exception
-.. php:exception:: NuVotifierException
diff --git a/docs/source/api/Exception/NuVotifierSignatureInvalidException.rst b/docs/source/api/Exception/NuVotifierSignatureInvalidException.rst
deleted file mode 100644
index a1a89ff..0000000
--- a/docs/source/api/Exception/NuVotifierSignatureInvalidException.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client\\Exception**
-
-===================================
-NuVotifierSignatureInvalidException
-===================================
-
-.. php:namespace:: D3strukt0r\Votifier\Client\Exception
-.. php:exception:: NuVotifierSignatureInvalidException
diff --git a/docs/source/api/Exception/NuVotifierUnknownServiceException.rst b/docs/source/api/Exception/NuVotifierUnknownServiceException.rst
deleted file mode 100644
index 77bf83a..0000000
--- a/docs/source/api/Exception/NuVotifierUnknownServiceException.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client\\Exception**
-
-=================================
-NuVotifierUnknownServiceException
-=================================
-
-.. php:namespace:: D3strukt0r\Votifier\Client\Exception
-.. php:exception:: NuVotifierUnknownServiceException
diff --git a/docs/source/api/Exception/NuVotifierUsernameTooLongException.rst b/docs/source/api/Exception/NuVotifierUsernameTooLongException.rst
deleted file mode 100644
index 6b4bf91..0000000
--- a/docs/source/api/Exception/NuVotifierUsernameTooLongException.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client\\Exception**
-
-==================================
-NuVotifierUsernameTooLongException
-==================================
-
-.. php:namespace:: D3strukt0r\Votifier\Client\Exception
-.. php:exception:: NuVotifierUsernameTooLongException
diff --git a/docs/source/api/Exception/Socket/NoConnectionException.rst b/docs/source/api/Exception/Socket/NoConnectionException.rst
deleted file mode 100644
index da322ab..0000000
--- a/docs/source/api/Exception/Socket/NoConnectionException.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client\\Exception\\Socket**
-
-=====================
-NoConnectionException
-=====================
-
-.. php:namespace:: D3strukt0r\Votifier\Client\Exception\Socket
-.. php:exception:: NoConnectionException
diff --git a/docs/source/api/Exception/Socket/PackageNotReceivedException.rst b/docs/source/api/Exception/Socket/PackageNotReceivedException.rst
deleted file mode 100644
index 095a2a7..0000000
--- a/docs/source/api/Exception/Socket/PackageNotReceivedException.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client\\Exception\\Socket**
-
-===========================
-PackageNotReceivedException
-===========================
-
-.. php:namespace:: D3strukt0r\Votifier\Client\Exception\Socket
-.. php:exception:: PackageNotReceivedException
diff --git a/docs/source/api/Exception/Socket/PackageNotSentException.rst b/docs/source/api/Exception/Socket/PackageNotSentException.rst
deleted file mode 100644
index 72a69bb..0000000
--- a/docs/source/api/Exception/Socket/PackageNotSentException.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client\\Exception\\Socket**
-
-=======================
-PackageNotSentException
-=======================
-
-.. php:namespace:: D3strukt0r\Votifier\Client\Exception\Socket
-.. php:exception:: PackageNotSentException
diff --git a/docs/source/api/Exception/Socket/index.rst b/docs/source/api/Exception/Socket/index.rst
deleted file mode 100644
index df2b09d..0000000
--- a/docs/source/api/Exception/Socket/index.rst
+++ /dev/null
@@ -1,14 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client\\Exception**
-
-========
-Socket\\
-========
-
-**Interfaces, Classes and Traits**
-
-.. toctree::
-    :maxdepth: 1
-
-    NoConnectionException
-    PackageNotReceivedException
-    PackageNotSentException
diff --git a/docs/source/api/Exception/index.rst b/docs/source/api/Exception/index.rst
deleted file mode 100644
index 6b06b85..0000000
--- a/docs/source/api/Exception/index.rst
+++ /dev/null
@@ -1,24 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client**
-
-===========
-Exception\\
-===========
-
-**Namespaces**
-
-.. toctree::
-    :maxdepth: 1
-
-    Socket/index
-
-**Interfaces, Classes and Traits**
-
-.. toctree::
-    :maxdepth: 1
-
-    NotVotifierException
-    NuVotifierChallengeInvalidException
-    NuVotifierException
-    NuVotifierSignatureInvalidException
-    NuVotifierUnknownServiceException
-    NuVotifierUsernameTooLongException
diff --git a/docs/source/api/Server/GenericServer.rst b/docs/source/api/Server/GenericServer.rst
deleted file mode 100644
index ed2904f..0000000
--- a/docs/source/api/Server/GenericServer.rst
+++ /dev/null
@@ -1,82 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client\\Server**
-
-=============
-GenericServer
-=============
-
-.. php:namespace:: D3strukt0r\Votifier\Client\Server
-.. php:class:: GenericServer
-
-    An abstract class that has all the important functions included for every server.
-
-    .. php:attr:: protected $socket
-
-        :php:class:`D3strukt0r\\Votifier\\Client\\Socket` — The socket object
-
-    .. php:attr:: protected $host
-
-        string — The domain or ip to connect to Votifier
-
-    .. php:attr:: protected $port
-
-        int — The port which votifier uses on the server
-
-    .. php:attr:: protected $publicKey
-
-        string — The public.key which is generated by the plugin
-
-    .. php:method:: public getSocket() -> Socket
-
-        Gets the Socket.
-
-        :returns: :php:class:`D3strukt0r\\Votifier\\Client\\Socket` — Returns a Socket object
-
-    .. php:method:: public setSocket($socket) -> $this
-
-        Sets the Socket.
-
-        :param string $socket: The socket object
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public getHost() -> string|null
-
-        Gets the host.
-
-        :returns: string|null — Returns the host
-
-    .. php:method:: public setHost($host) -> $this
-
-        Sets the host.
-
-        :param string $host: The host
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public getPort() -> int
-
-        Gets the port.
-
-        :returns: int — Returns the port
-
-    .. php:method:: public setPort($port) -> $this
-
-        Sets the port.
-
-        :param int $port: The port
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public getPublicKey() -> string|null
-
-        Gets the public key.
-
-        :returns: string|null — Returns the public key
-
-    .. php:method:: public setPublicKey($publicKey) -> $this
-
-        Sets the public key.
-
-        :param string $publicKey: The public key
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
diff --git a/docs/source/api/Server/NuVotifier.rst b/docs/source/api/Server/NuVotifier.rst
deleted file mode 100644
index 1e43cfd..0000000
--- a/docs/source/api/Server/NuVotifier.rst
+++ /dev/null
@@ -1,219 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client\\Server**
-
-==========
-NuVotifier
-==========
-
-.. php:namespace:: D3strukt0r\Votifier\Client\Server
-.. php:class:: NuVotifier
-
-    The Class to access a server which uses the plugin "NuVotifier".
-
-    .. php:attr:: protected $socket
-
-        :php:class:`D3strukt0r\\Votifier\\Client\\Socket` — The socket object
-
-    .. php:attr:: protected $host
-
-        string — The domain or ip to connect to Votifier
-
-    .. php:attr:: protected $port
-
-        int — The port which votifier uses on the server
-
-    .. php:attr:: protected $publicKey
-
-        string — The public.key which is generated by the plugin
-
-    .. php:attr:: protected $protocolV2
-
-        bool — Use version 2 of the protocol
-
-    .. php:attr:: protected $token
-
-        string|null — The token from the config.yml
-
-    .. php:method:: public getSocket() -> Socket
-
-        Gets the Socket.
-
-        :returns: :php:class:`D3strukt0r\\Votifier\\Client\\Socket` — Returns a Socket object
-
-    .. php:method:: public setSocket($socket) -> $this
-
-        Sets the Socket.
-
-        :param string $socket: The socket object
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public getHost() -> string|null
-
-        Gets the host.
-
-        :returns: string|null — Returns the host
-
-    .. php:method:: public setHost($host) -> $this
-
-        Sets the host.
-
-        :param string $host: The host
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public getPort() -> int
-
-        Gets the port.
-
-        :returns: int — Returns the port
-
-    .. php:method:: public setPort($port) -> $this
-
-        Sets the port.
-
-        :param int $port: The port
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public getPublicKey() -> string|null
-
-        Gets the public key.
-
-        :returns: string|null — Returns the public key
-
-    .. php:method:: public setPublicKey($publicKey) -> $this
-
-        Sets the public key.
-
-        :param string $publicKey: The public key
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public isProtocolV2() -> bool
-
-        Checks whether the connection uses the version 2 protocol.
-
-        :returns: bool — Returns true, if using the new version of NuVotifier or false otherwise
-
-    .. php:method:: public setProtocolV2($isProtocolV2) -> $this
-
-        Sets whether to use version 2 of the protocol.
-
-        :param bool $isProtocolV2: Whether to use version 2 of the protocol
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public getToken() -> string|null
-
-        Gets the token from the config.yml.
-
-        :returns: string|null — Returns The token from the config.yml
-
-    .. php:method:: public setToken($token) -> $this
-
-        Sets the token from the config.yml.
-
-        :param string|null $token: The token from the config.yml
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public verifyConnection()
-
-        Checks if the server actually belongs to Votifier.
-
-        :throws: :php:exc:`InvalidArgumentException`
-
-            If one required parameter wasn't set
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\NoConnectionException`
-
-            If connection couldn't be established
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\PackageNotReceivedException`
-
-            If there was an error receiving the package
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\NotVotifierException`
-
-            If the server we are connected to is not a valid Votifier server
-
-    .. php:method:: public sendVote(...$votes)
-
-        Sends the vote packages to the server.
-
-        :param \\D3strukt0r\\Votifier\\Client\\Vote\\VoteInterface $votes: The vote packages
-
-        :throws: :php:exc:`InvalidArgumentException`
-
-            If one required parameter wasn't set
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\NoConnectionException`
-
-            If connection couldn't be established
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\PackageNotSentException`
-
-            If there was an error receiving the package
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\PackageNotReceivedException`
-
-            If there was an error sending the package
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\NotVotifierException`
-
-            If the server we are connected to is not a valid Votifier server
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\NuVotifierException`
-
-            General NuVotifier Exception (an unknown exception)
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\NuVotifierChallengeInvalidException`
-
-            NuVotifier says the challenge was invalid
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\NuVotifierSignatureInvalidException`
-
-            NuVotifier says the signature was invalid
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\NuVotifierUnknownServiceException`
-
-            NuVotifier says that the service is unknown (the token doesn't belong to the service name)
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\NuVotifierUsernameTooLongException`
-
-            NuVotifier says the username is too long
-
-    .. php:method:: protected checkRequiredVariablesForPackage($vote)
-
-        Check that service name, username, address, timestamp and token have been set.
-
-        :param D3strukt0r\\Votifier\\Client\\Vote\\VoteInterface $vote: The vote to check
-
-        :throws: :php:exc:`InvalidArgumentException`
-
-            If one required parameter wasn't set
-
-    .. php:method:: protected verifyConnection($header) -> bool
-
-        Verifies that the connection is correct.
-
-        :param string|null $header: The header that the plugin usually sends
-
-        :returns: bool — Returns true if connections is available, otherwise false
-
-    .. php:method:: protected preparePackage($vote) -> string
-
-        Create encrypted package for default Votifier.
-
-        :param \\D3strukt0r\\Votifier\\Client\\Vote\\VoteInterface $vote: The vote package with all the information
-
-        :returns: string — Returns the string to be sent to the server
-
-    .. php:method:: protected preparePackageV2($vote, $challenge) -> string
-
-        Prepares the vote package to be sent as version 2 protocol package.
-
-        :param D3strukt0r\\Votifier\\Client\\Vote\\VoteInterface $vote: The vote package with information
-        :param string $challenge: The challenge sent by the server
-
-        :returns: string — Returns the string to be sent to the server
diff --git a/docs/source/api/Server/ServerInterface.rst b/docs/source/api/Server/ServerInterface.rst
deleted file mode 100644
index 822d4ae..0000000
--- a/docs/source/api/Server/ServerInterface.rst
+++ /dev/null
@@ -1,98 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client\\Server**
-
-===============
-ServerInterface
-===============
-
-.. php:namespace:: D3strukt0r\Votifier\Client\Server
-.. php:interface:: ServerInterface
-
-    The interface ServerInterface is used to define a PluginType on the server.
-
-    .. php:method:: public getHost() -> string|null
-
-        Gets the host.
-
-        :returns: string|null — Returns the host
-
-    .. php:method:: public setHost($host)
-
-        Sets the host.
-
-        :param string $host: The host
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public getPort() -> int
-
-        Gets the port.
-
-        :returns: int — Returns the port
-
-    .. php:method:: public setPort($port)
-
-        Sets the port.
-
-        :param int $port: The port
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public getPublicKey() -> string|null
-
-        Gets the public key.
-
-        :returns: string|null — Returns the public key
-
-    .. php:method:: public setPublicKey($publicKey)
-
-        Sets the public key.
-
-        :param string $publicKey: The public key
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public verifyConnection()
-
-        Checks if the server actually belongs to Votifier.
-
-        :throws: :php:exc:`InvalidArgumentException`
-            
-            If one required parameter wasn't set
-        
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\NoConnectionException`
-        
-            If connection couldn't be established
-            
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\PackageNotReceivedException`
-            
-            If there was an error receiving the package
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\NotVotifierException`
-        
-            If the server we are connected to is not a valid Votifier server
-
-    .. php:method:: public sendVote(...$votes)
-
-        Sends the vote packages to the server.
-
-        :param D3strukt0r\\Votifier\\Client\\Vote\\VoteInterface $votes: The vote packages
-
-        :throws: :php:exc:`InvalidArgumentException`
-            
-            If one required parameter wasn't set
-        
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\NoConnectionException`
-        
-            If connection couldn't be established
-            
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\PackageNotReceivedException`
-            
-            If there was an error receiving the package
-            
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\PackageNotSentException`
-            
-            If there was an error sending the package
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\NotVotifierException`
-        
-            If the server we are connected to is not a valid Votifier server
diff --git a/docs/source/api/Server/Votifier.rst b/docs/source/api/Server/Votifier.rst
deleted file mode 100644
index c0debdd..0000000
--- a/docs/source/api/Server/Votifier.rst
+++ /dev/null
@@ -1,158 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client\\Server**
-
-========
-Votifier
-========
-
-.. php:namespace:: D3strukt0r\Votifier\Client\Server
-.. php:class:: Votifier
-
-    The Class to access a server which uses the classic "Votifier" plugin.
-
-    .. php:attr:: protected $socket
-
-        :php:class:`D3strukt0r\\Votifier\\Client\\Socket` — The socket object
-
-    .. php:attr:: protected $host
-
-        string — The domain or ip to connect to Votifier
-
-    .. php:attr:: protected $port
-
-        int — The port which votifier uses on the server
-
-    .. php:attr:: protected $publicKey
-
-        string — The public.key which is generated by the plugin
-
-    .. php:method:: public getSocket() -> Socket
-
-        Gets the Socket.
-
-        :returns: :php:class:`D3strukt0r\\Votifier\\Client\\Socket` — Returns a Socket object
-
-    .. php:method:: public setSocket($socket) -> $this
-
-        Sets the Socket.
-
-        :param string $socket: The socket object
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public getHost() -> string|null
-
-        Gets the host.
-
-        :returns: string|null — Returns the host
-
-    .. php:method:: public setHost($host) -> $this
-
-        Sets the host.
-
-        :param string $host: The host
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public getPort() -> int
-
-        Gets the port.
-
-        :returns: int — Returns the port
-
-    .. php:method:: public setPort($port) -> $this
-
-        Sets the port.
-
-        :param int $port: The port
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public getPublicKey() -> string|null
-
-        Gets the public key.
-
-        :returns: string|null — Returns the public key
-
-    .. php:method:: public setPublicKey($publicKey) -> $this
-
-        Sets the public key.
-
-        :param string $publicKey: The public key
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public verifyConnection()
-
-        Checks if the server actually belongs to Votifier.
-
-        :throws: :php:exc:`InvalidArgumentException`
-
-            If one required parameter wasn't set
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\NoConnectionException`
-
-            If connection couldn't be established
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\PackageNotReceivedException`
-
-            If there was an error receiving the package
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\NotVotifierException`
-
-            If the server we are connected to is not a valid Votifier server
-
-    .. php:method:: public sendVote(...$votes)
-
-        Sends the vote packages to the server.
-
-        :param \\D3strukt0r\\Votifier\\Client\\Vote\\VoteInterface $votes: The vote packages
-
-        :throws: :php:exc:`InvalidArgumentException`
-
-            If one required parameter wasn't set
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\NoConnectionException`
-
-            If connection couldn't be established
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\PackageNotSentException`
-
-            If there was an error receiving the package
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\PackageNotReceivedException`
-
-            If there was an error sending the package
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\NotVotifierException`
-
-            If the server we are connected to is not a valid Votifier server
-
-    .. php:method:: protected checkRequiredVariablesForSocket()
-
-        Check that both host and port have been set.
-
-        :throws: :php:exc:`InvalidArgumentException` — If one required parameter wasn't set
-
-    .. php:method:: protected checkRequiredVariablesForPackage($vote)
-
-        Check that service name, username, address, timestamp and public key have been set.
-
-        :param D3strukt0r\\Votifier\\Client\\Vote\\VoteInterface $vote: The vote to check
-
-        :throws: :php:exc:`InvalidArgumentException` — If one required parameter wasn't set
-
-    .. php:method:: protected verifyConnection($header) -> bool
-
-        Verifies that the connection is correct.
-
-        :param string|null $header: The header that the plugin usually sends
-
-        :returns: bool — Returns true if connections is available, otherwise false
-
-    .. php:method:: protected preparePackage($vote) -> string
-
-        Create encrypted package for default Votifier.
-
-        :param \\D3strukt0r\\Votifier\\Client\\Vote\\VoteInterface $vote: The vote package with all the information
-
-        :returns: string — Returns the string to be sent to the server
diff --git a/docs/source/api/Server/index.rst b/docs/source/api/Server/index.rst
deleted file mode 100644
index 5aeafa0..0000000
--- a/docs/source/api/Server/index.rst
+++ /dev/null
@@ -1,21 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client**
-
-========
-Server\\
-========
-
-**Interfaces**
-
-.. toctree::
-    :maxdepth: 1
-
-    ServerInterface
-
-**Interfaces, Classes and Traits**
-
-.. toctree::
-    :maxdepth: 1
-
-    GenericServer
-    Votifier
-    NuVotifier
diff --git a/docs/source/api/Socket.rst b/docs/source/api/Socket.rst
deleted file mode 100644
index aee63a2..0000000
--- a/docs/source/api/Socket.rst
+++ /dev/null
@@ -1,47 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client**
-
-======
-Socket
-======
-
-.. php:namespace:: D3strukt0r\Votifier\Client
-.. php:class:: Socket
-
-    The class ServerConnection is used to create a connection to a server.
-
-    .. php:attr:: private $socket
-
-        resource — The connection to the server
-
-    .. php:method:: public __destruct()
-
-        Closes the connection when the object is destroyed.
-
-    .. php:method:: public open($host, $port)
-
-        Creates the ServerConnection object.
-
-        :param string $host: The hostname or IP address
-        :param int $port: The port of Votifier
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\NoConnectionException` — If connection couldn't be established
-
-    .. php:method:: public write($string)
-
-        Sends a string to the server.
-
-        :param string $string: The string which should be sent to the server
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\NoConnectionException` — If connection has not been set up
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\PackageNotSentException` — If there was an error sending the package
-
-    .. php:method:: public read([$length = 64]) -> string
-
-        Reads a string which is being received from the server.
-
-        :param int $length: [optional] The length of the requested string
-
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\NoConnectionException` — If connection has not been set up
-        :throws: :php:exc:`D3strukt0r\\Votifier\\Client\\Exception\\Socket\\PackageNotReceivedException` — If there was an error receiving the package
-
-        :returns: string — Returns the string received from the server
diff --git a/docs/source/api/Vote/ClassicVote.rst b/docs/source/api/Vote/ClassicVote.rst
deleted file mode 100644
index 3499ad7..0000000
--- a/docs/source/api/Vote/ClassicVote.rst
+++ /dev/null
@@ -1,82 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client\\Vote**
-
-===========
-ClassicVote
-===========
-
-.. php:namespace:: D3strukt0r\Votifier\Client\Vote
-.. php:class:: ClassicVote
-
-    The classic vote package can be used by most plugins.
-
-    .. php:attr:: protected $serviceName
-
-        string — The name of the list/service
-
-    .. php:attr:: protected $username
-
-        string — The username who wants to receive the rewards
-
-    .. php:attr:: protected $address
-
-        string — The IP Address of the user
-
-    .. php:attr:: protected $timestamp
-
-        :php:class:`DateTime` — The time when the vote will be sent
-
-    .. php:method:: public getServiceName() -> string|null
-
-        The name of the list/service.
-
-        :returns: string|null — Returns the name of the list/service
-
-    .. php:method:: public setServiceName($serviceName) -> $this
-
-        Sets the name of the list/service.
-
-        :param string $serviceName: The name of the list/service
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public getUsername() -> string|null
-
-        Gets the username of the user who wants to receive the rewards.
-
-        :returns: string|null — Returns the username who wants to receive the rewards
-
-    .. php:method:: public setUsername($username) -> $this
-
-        Sets the username of the user who wants to receive the rewards.
-
-        :param string $username: The username of the user who wants to receive the rewards
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public getAddress() -> string
-
-        Gets the IP Address of the user.
-
-        :returns: string — Returns the IP Address of the user
-
-    .. php:method:: public setAddress($address) -> $this
-
-        Sets the IP Address of the user.
-
-        :param string $address: The IP address the user is sending a request from
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public getTimestamp() -> int|null
-
-        Gets the time when the vote was sent.
-
-        :returns: int|null — Returns the time when the vote was sent, null otherwise
-
-    .. php:method:: public setTimestamp([$timestamp = null]) -> $this
-
-        Sets the time when the vote will be sent.
-
-        :param DateTime|null $timestamp: [optional] Either give a wanted timestamp or it will use the current time
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
diff --git a/docs/source/api/Vote/VoteInterface.rst b/docs/source/api/Vote/VoteInterface.rst
deleted file mode 100644
index 2c02438..0000000
--- a/docs/source/api/Vote/VoteInterface.rst
+++ /dev/null
@@ -1,66 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client\\VoteType**
-
-=============
-VoteInterface
-=============
-
-.. php:namespace:: D3strukt0r\Votifier\Client\VoteType
-.. php:interface:: VoteInterface
-
-    The interface VoteInterface will be used for different kinds of vote packages.
-
-    .. php:method:: public getServiceName() -> string|null
-
-        The name of the list/service.
-
-        :returns: string|null — Returns the name of the list/service
-
-    .. php:method:: public setServiceName($serviceName)
-
-        Sets the name of the list/service.
-
-        :param string $serviceName: The name of the list/service
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public getUsername() -> string|null
-
-        Gets the username of the user who wants to receive the rewards.
-
-        :returns: string|null — Returns the username who wants to receive the rewards
-
-    .. php:method:: public setUsername($username)
-
-        Sets the username of the user who wants to receive the rewards.
-
-        :param string $username: The username of the user who wants to receive the rewards
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public getAddress() -> string
-
-        Gets the IP Address of the user.
-
-        :returns: string — Returns the IP Address of the user
-
-    .. php:method:: public setAddress($address)
-
-        Sets the IP Address of the user.
-
-        :param string $address: The IP address the user is sending a request from
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
-
-    .. php:method:: public getTimestamp() -> int|null
-
-        Gets the time when the vote was sent.
-
-        :returns: int|null — Returns the time when the vote was sent, null otherwise
-
-    .. php:method:: public setTimestamp([$timestamp = null])
-
-        Sets the time when the vote will be sent.
-
-        :param DateTime|null $timestamp: [optional] Either give a wanted timestamp or it will use the current time
-
-        :returns: $this — Returns the class itself, for doing multiple things at once
diff --git a/docs/source/api/Vote/index.rst b/docs/source/api/Vote/index.rst
deleted file mode 100644
index 51fb2ec..0000000
--- a/docs/source/api/Vote/index.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-**\\D3strukt0r\\Votifier\\Client**
-
-======
-Vote\\
-======
-
-**Interfaces, Classes and Traits**
-
-.. toctree::
-    :maxdepth: 1
-
-    VoteInterface
-    ClassicVote
diff --git a/docs/source/api/index.rst b/docs/source/api/index.rst
index f9a2e55..ddbf2d3 100644
--- a/docs/source/api/index.rst
+++ b/docs/source/api/index.rst
@@ -1,19 +1,14 @@
-================================
-\\D3strukt0r\\Votifier\\Client\\
-================================
+=============
+API Reference
+=============
 
-**Namespaces**
+There is no hand-maintained API reference here. Every class, method and
+parameter in the library is documented with PHPDoc directly in the source, so
+the source is the single, always-up-to-date reference.
 
-.. toctree::
-    :maxdepth: 1
+If you are interested in the API, read the source code:
 
-    Exception/index
-    Server/index
-    Vote/index
+`Browse the source on GitHub <https://github.com/Team-MaRo/votifier-client-php/tree/master/src>`_
 
-**Interfaces, Classes and Traits**
-
-.. toctree::
-    :maxdepth: 1
-
-    Socket
+For practical usage, see the :doc:`Getting Started <../getting-started/votifier>`
+section.
diff --git a/docs/source/appendix/changelog.rst b/docs/source/appendix/changelog.rst
index dfba06c..4a57ee2 100644
--- a/docs/source/appendix/changelog.rst
+++ b/docs/source/appendix/changelog.rst
@@ -1,59 +1,5 @@
-=========
-Changelog
-=========
+.. Pulled from the root CHANGELOG.md so the documentation and the repository
+   changelog never drift apart.
 
-3.0.0
-=====
-- :code:`Added` :code:`verifyConnection` function to server, to check the server separately. You can figure out if the server is from Votifier before sending a vote
-- :code:`Added` php compatibility check for code style check
-- :code:`Added` Added setter methods to servers and and votes in place of constructor
-- :code:`Added` exceptions for all possible errors (instead of the old Messages class)
-- :code:`Dropped` assigning variables in the constructor
-- :code:`Dropped` :code:`Messages` class
-- :code:`Moved` namespace to :code:`D3strukt0r\Votifier\Client\Server`
-- :code:`Fixed` composer not ignoring unnecessary files
-- :code:`Fixed` coverage reports
-- :code:`Fixed` coding style
-- :code:`Updated` the docs
-
-2.1.2
-=====
-Nothing changed in the code, only improved CI and fixed Coverage report
-
-2.1.1
-=====
-- :code:`Added` more documentation using "Read the Docs"
-- :code:`Fixed` Bug `#1 <https://github.com/D3strukt0r/votifier-client-php/issues/1>`_
-
-2.1.0
-=====
-- :code:`Added` some required PHP libraries
-- :code:`Dropped` compatibility with depreciated PHP versions. Now PHP 7.1+ is required
-- :code:`Fixed` Travis tests
-- :code:`Fixed` coding style
-- :code:`Updated` the docs
-
-TODO
-----
-- :code:`Add` more tests
-
-2.0.0
-=====
-- :code:`Added` server types (to use with different plugins) (Currently: Votifier/NuVotifier)
-- :code:`Added` vote types, in case different package types are needed.
-- :code:`Added` API Docs using phpDocumentor
-
-Notes
------
-Anyone who thinks a new ServerType is needed can open an issue and I'll add it to a minor release.
-I already tested Votifier/NuVotifier protocol v1/NuVotifier protocol v2 manually and it worked
-
-1.0.0
-=====
-- :code:`Added` coveralls
-- :code:`Removed` unnecessary code
-- :code:`Fixed` code style
-
-0.0.1-beta
-==========
-Begin project
+.. include:: ../../../CHANGELOG.md
+   :parser: myst_parser.docutils_
diff --git a/docs/source/appendix/code-of-conduct.rst b/docs/source/appendix/code-of-conduct.rst
index 7bfb6d7..27f21f1 100644
--- a/docs/source/appendix/code-of-conduct.rst
+++ b/docs/source/appendix/code-of-conduct.rst
@@ -1,51 +1,5 @@
-===============
-Code of conduct
-===============
+.. Pulled from the central Team-MaRo/.github repo (the docs/source/_community
+   submodule) so it is never duplicated or out of date here.
 
-Our Pledge
-==========
-
-In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
-
-Our Standards
-=============
-
-Examples of behavior that contributes to creating a positive environment include:
-
-- Using welcoming and inclusive language
-- Being respectful of differing viewpoints and experiences
-- Gracefully accepting constructive criticism
-- Focusing on what is best for the community
-- Showing empathy towards other community members
-
-Examples of unacceptable behavior by participants include:
-
-- The use of sexualized language or imagery and unwelcome sexual attention or advances
-- Trolling, insulting/derogatory comments, and personal or political attacks
-- Public or private harassment
-- Publishing others' private information, such as a physical or electronic address, without explicit permission
-- Other conduct which could reasonably be considered inappropriate in a professional setting
-
-Our Responsibilities
-====================
-
-Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
-
-Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
-
-Scope
-=====
-
-This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
-
-Enforcement
-===========
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at manuele.vaccari@gmail.com. All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
-
-Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
-
-Attribution
-===========
-
-This Code of Conduct is adapted from the `Contributor Covenant <http://contributor-covenant.org>`_, version 1.4, available at http://contributor-covenant.org/version/1/4/
+.. include:: ../_community/CODE_OF_CONDUCT.md
+   :parser: myst_parser.docutils_
diff --git a/docs/source/appendix/contributing.rst b/docs/source/appendix/contributing.rst
index c4120dc..277eb23 100644
--- a/docs/source/appendix/contributing.rst
+++ b/docs/source/appendix/contributing.rst
@@ -1,14 +1,27 @@
-============
-Contributing
-============
+.. Pulled from the central Team-MaRo/.github repo (the docs/source/_community
+   submodule) so it is never duplicated or out of date here.
 
-When contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with the owners of this repository before making a change.
+.. include:: ../_community/CONTRIBUTING.md
+   :parser: myst_parser.docutils_
 
-Please note we have a code of conduct, please follow it in all your interactions with the project.
+Code style guidelines
+=====================
 
-.. toctree::
-   :maxdepth: 2
+This project enforces two complementary code-style tools, both run by CI — make
+sure both pass before opening a pull request.
 
-   contributing/ways-to-contribute
-   contributing/pull-request-workflow
-   contributing/code-style-guidelines
+**PHP_CodeSniffer** checks PSR-12 and PHP version compatibility (configured in
+``.phpcs.xml``):
+
+.. code-block:: bash
+
+    composer check    # report problems  (alias for: ./vendor/bin/phpcs)
+    composer fix      # auto-fix them     (alias for: ./vendor/bin/phpcbf)
+
+**PHP-CS-Fixer** applies the project's coding standard (configured in
+``.php-cs-fixer.dist.php``):
+
+.. code-block:: bash
+
+    composer cs       # show the diff without changing files
+    composer cs:fix   # apply the fixes
diff --git a/docs/source/appendix/contributing/code-style-guidelines.rst b/docs/source/appendix/contributing/code-style-guidelines.rst
deleted file mode 100644
index 24d2be3..0000000
--- a/docs/source/appendix/contributing/code-style-guidelines.rst
+++ /dev/null
@@ -1,33 +0,0 @@
-=====================
-Code style guidelines
-=====================
-
-This project has CodeSniffer as a dependency. So before creating a pull-request, make sure it doesn't show any warnings. The CI will test this too. You can try in two ways.
-
-.. code-block:: bash
-
-    ./vendor/bin/phpcs
-
-.. code-block:: bash
-
-    composer run-script check
-
-And to fix it with :code:`phpcbf` you can run it with
-
-.. code-block:: bash
-
-    ./vendor/bin/phpcbf
-
-.. code-block:: bash
-
-    composer run-script fix
-
-PHP-CS-Fixer is also installed, but because it's impossible to set it up to support PSR-12, I have removed it from being a requirement and left it as just "for information". You can try it anyways.
-
-.. code-block:: bash
-
-    ./vendor/bin/php-cs-fixer
-
-.. code-block:: bash
-
-    composer run-script check2
diff --git a/docs/source/appendix/contributing/pull-request-workflow.rst b/docs/source/appendix/contributing/pull-request-workflow.rst
deleted file mode 100644
index 9fb3023..0000000
--- a/docs/source/appendix/contributing/pull-request-workflow.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-=====================
-Pull request workflow
-=====================
-
-1.  Ensure any install or build dependencies are removed before the end of the layer when doing a build.
-2.  Update the README.md with details of changes to the interface, this includes new environment variables, exposed ports, useful file locations and container parameters.
-3.  Increase the version numbers in any examples files and the README.md to the new version that this Pull Request would represent. The versioning scheme we use is `SemVer <http://semver.org/>`_.
-4.  You may merge the Pull Request in once you have the sign-off of two other developers, or if you do not have permission to do that, you may request the second reviewer to merge it for you.
diff --git a/docs/source/appendix/contributing/ways-to-contribute.rst b/docs/source/appendix/contributing/ways-to-contribute.rst
deleted file mode 100644
index b870afb..0000000
--- a/docs/source/appendix/contributing/ways-to-contribute.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-==================
-Ways to contribute
-==================
-
-- Contribute with code on Github
-- Donate some money to support my life basically (Links can be found on the Github project page)
-- Tell people who could be interested about this library
diff --git a/docs/source/appendix/copyright.rst b/docs/source/appendix/copyright.rst
index 004ea49..8a85d0e 100644
--- a/docs/source/appendix/copyright.rst
+++ b/docs/source/appendix/copyright.rst
@@ -1,148 +1,34 @@
-.. role:: bold-italic
-  :class: bold-italic
-.. role:: underline
-  :class: underline
-
 =========
 Copyright
 =========
 
-*Creative Commons Corporation (“Creative Commons”) is not a law firm and does not provide legal services or legal advice. Distribution of Creative Commons public licenses does not create a lawyer-client or other relationship. Creative Commons makes its licenses and related information available on an “as-is” basis. Creative Commons gives no warranties regarding its licenses, any material licensed under their terms and conditions, or any related information. Creative Commons disclaims all liability for damages resulting from their use to the fullest extent possible.*
-
-:bold-italic:`Using Creative Commons Public Licenses`
-
-Creative Commons public licenses provide a standard set of terms and conditions that creators and other rights holders may use to share original works of authorship and other material subject to copyright and certain other rights specified in the public license below. The following considerations are for informational purposes only, are not exhaustive, and do not form part of our licenses.
-
-:bold-italic:`Considerations for licensors:` Our public licenses are intended for use by those authorized to give the public permission to use material in ways otherwise restricted by copyright and certain other rights. Our licenses are irrevocable. Licensors should read and understand the terms and conditions of the license they choose before applying it. Licensors should also secure all rights necessary before applying our licenses so that the public can reuse the material as expected. Licensors should clearly mark any material not subject to the license. This includes other CC-licensed material, or material used under an exception or limitation to copyright. `More considerations for licensors. <https://wiki.creativecommons.org/Considerations_for_licensors_and_licensees#Considerations_for_licensors>`_
-
-:bold-italic:`Considerations for the public`: By using one of our public licenses, a licensor grants the public permission to use the licensed material under specified terms and conditions. If the licensor’s permission is not necessary for any reason–for example, because of any applicable exception or limitation to copyright–then that use is not regulated by the license. Our licenses grant only permissions under copyright and certain other rights that a licensor has authority to grant. Use of the licensed material may still be restricted for other reasons, including because others have copyright or other rights in the material. A licensor may make special requests, such as asking that all changes be marked or described. Although not required by our licenses, you are encouraged to respect those requests where reasonable. `More considerations for the public. <https://wiki.creativecommons.org/Considerations_for_licensors_and_licensees#Considerations_for_licensees>`_
-
-Creative Commons Attribution-ShareAlike 4.0 International Public License
-========================================================================
-By exercising the Licensed Rights (defined below), You accept and agree to be bound by the terms and conditions of this Creative Commons Attribution-ShareAlike 4.0 International Public License ("Public License"). To the extent this Public License may be interpreted as a contract, You are granted the Licensed Rights in consideration of Your acceptance of these terms and conditions, and the Licensor grants You such rights in consideration of benefits the Licensor receives from making the Licensed Material available under these terms and conditions.
-
-Section 1 – Definitions.
-------------------------
-
-a. **Adapted Material** means material subject to Copyright and Similar Rights that is derived from or based upon the Licensed Material and in which the Licensed Material is translated, altered, arranged, transformed, or otherwise modified in a manner requiring permission under the Copyright and Similar Rights held by the Licensor. For purposes of this Public License, where the Licensed Material is a musical work, performance, or sound recording, Adapted Material is always produced where the Licensed Material is synched in timed relation with a moving image.
-b. **Adapter's License** means the license You apply to Your Copyright and Similar Rights in Your contributions to Adapted Material in accordance with the terms and conditions of this Public License.
-c. **BY-SA Compatible License** means a license listed at `creativecommons.org/compatiblelicenses <http://creativecommons.org/compatiblelicenses>`_, approved by Creative Commons as essentially the equivalent of this Public License.
-d. **Copyright and Similar Rights** means copyright and/or similar rights closely related to copyright including, without limitation, performance, broadcast, sound recording, and Sui Generis Database Rights, without regard to how the rights are labeled or categorized. For purposes of this Public License, the rights specified in Section 2(b)(1)-(2) are not Copyright and Similar Rights.
-e. **Effective Technological Measures** means those measures that, in the absence of proper authority, may not be circumvented under laws fulfilling obligations under Article 11 of the WIPO Copyright Treaty adopted on December 20, 1996, and/or similar international agreements.
-f. **Exceptions and Limitations** means fair use, fair dealing, and/or any other exception or limitation to Copyright and Similar Rights that applies to Your use of the Licensed Material.
-g. **License Elements** means the license attributes listed in the name of a Creative Commons Public License. The License Elements of this Public License are Attribution and ShareAlike.
-h. **Licensed Material** means the artistic or literary work, database, or other material to which the Licensor applied this Public License.
-i. **Licensed Rights** means the rights granted to You subject to the terms and conditions of this Public License, which are limited to all Copyright and Similar Rights that apply to Your use of the Licensed Material and that the Licensor has authority to license.
-j. **Licensor** means the individual(s) or entity(ies) granting rights under this Public License.
-k. **Share** means to provide material to the public by any means or process that requires permission under the Licensed Rights, such as reproduction, public display, public performance, distribution, dissemination, communication, or importation, and to make material available to the public including in ways that members of the public may access the material from a place and at a time individually chosen by them.
-l. **Sui Generis Database Rights** means rights other than copyright resulting from Directive 96/9/EC of the European Parliament and of the Council of 11 March 1996 on the legal protection of databases, as amended and/or succeeded, as well as other essentially equivalent rights anywhere in the world.
-m. **You** means the individual or entity exercising the Licensed Rights under this Public License. **Your** has a corresponding meaning.
-
-Section 2 – Scope.
-------------------
-
-a. **License grant.**
-
-   1. Subject to the terms and conditions of this Public License, the Licensor hereby grants You a worldwide, royalty-free, non-sublicensable, non-exclusive, irrevocable license to exercise the Licensed Rights in the Licensed Material to:
-
-      A. reproduce and Share the Licensed Material, in whole or in part; and
-      B. produce, reproduce, and Share Adapted Material.
-
-   2. :underline:`Exceptions and Limitations`. For the avoidance of doubt, where Exceptions and Limitations apply to Your use, this Public License does not apply, and You do not need to comply with its terms and conditions.
-   3. :underline:`Term`. The term of this Public License is specified in Section 6(a).
-   4. :underline:`Media and formats; technical modifications allowed`. The Licensor authorizes You to exercise the Licensed Rights in all media and formats whether now known or hereafter created, and to make technical modifications necessary to do so. The Licensor waives and/or agrees not to assert any right or authority to forbid You from making technical modifications necessary to exercise the Licensed Rights, including technical modifications necessary to circumvent Effective Technological Measures. For purposes of this Public License, simply making modifications authorized by this Section 2(a)(4) never produces Adapted Material.
-   5. :underline:`Downstream recipients`.
-
-      A. :underline:`Offer from the Licensor – Licensed Material`. Every recipient of the Licensed Material automatically receives an offer from the Licensor to exercise the Licensed Rights under the terms and conditions of this Public License.
-      B. :underline:`Additional offer from the Licensor – Adapted Material`. Every recipient of Adapted Material from You automatically receives an offer from the Licensor to exercise the Licensed Rights in the Adapted Material under the conditions of the Adapter’s License You apply.
-      C. :underline:`No downstream restrictions`. You may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, the Licensed Material if doing so restricts exercise of the Licensed Rights by any recipient of the Licensed Material.
-
-   6. :underline:`No endorsement`. Nothing in this Public License constitutes or may be construed as permission to assert or imply that You are, or that Your use of the Licensed Material is, connected with, or sponsored, endorsed, or granted official status by, the Licensor or others designated to receive attribution as provided in Section 3(a)(1)(A)(i).
-b. **Other rights.**
-
-   1. Moral rights, such as the right of integrity, are not licensed under this Public License, nor are publicity, privacy, and/or other similar personality rights; however, to the extent possible, the Licensor waives and/or agrees not to assert any such rights held by the Licensor to the limited extent necessary to allow You to exercise the Licensed Rights, but not otherwise.
-   2. Patent and trademark rights are not licensed under this Public License.
-   3. To the extent possible, the Licensor waives any right to collect royalties from You for the exercise of the Licensed Rights, whether directly or through a collecting society under any voluntary or waivable statutory or compulsory licensing scheme. In all other cases the Licensor expressly reserves any right to collect such royalties.
-
-Section 3 – License Conditions.
--------------------------------
-
-Your exercise of the Licensed Rights is expressly made subject to the following conditions.
-
-a. **Attribution.**
-
-   1. If You Share the Licensed Material (including in modified form), You must:
-
-      A. retain the following if it is supplied by the Licensor with the Licensed Material:
-
-         i. identification of the creator(s) of the Licensed Material and any others designated to receive attribution, in any reasonable manner requested by the Licensor (including by pseudonym if designated);
-         ii. a copyright notice;
-         iii. a notice that refers to this Public License;
-         iv. a notice that refers to the disclaimer of warranties;
-         v. a URI or hyperlink to the Licensed Material to the extent reasonably practicable;
-
-      B. indicate if You modified the Licensed Material and retain an indication of any previous modifications; and
-      C. indicate the Licensed Material is licensed under this Public License, and include the text of, or the URI or hyperlink to, this Public License.
-
-   2. You may satisfy the conditions in Section 3(a)(1) in any reasonable manner based on the medium, means, and context in which You Share the Licensed Material. For example, it may be reasonable to satisfy the conditions by providing a URI or hyperlink to a resource that includes the required information.
-   3. If requested by the Licensor, You must remove any of the information required by Section 3(a)(1)(A) to the extent reasonably practicable.
-
-b. **ShareAlike.**
-
-   In addition to the conditions in Section 3(a), if You Share Adapted Material You produce, the following conditions also apply.
-
-   1. The Adapter’s License You apply must be a Creative Commons license with the same License Elements, this version or later, or a BY-SA Compatible License.
-   2. You must include the text of, or the URI or hyperlink to, the Adapter's License You apply. You may satisfy this condition in any reasonable manner based on the medium, means, and context in which You Share Adapted Material.
-   3. You may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, Adapted Material that restrict exercise of the rights granted under the Adapter's License You apply.
-
-Section 4 – Sui Generis Database Rights.
-----------------------------------------
-
-Where the Licensed Rights include Sui Generis Database Rights that apply to Your use of the Licensed Material:
-
-a. for the avoidance of doubt, Section 2(a)(1) grants You the right to extract, reuse, reproduce, and Share all or a substantial portion of the contents of the database;
-b. if You include all or a substantial portion of the database contents in a database in which You have Sui Generis Database Rights, then the database in which You have Sui Generis Database Rights (but not its individual contents) is Adapted Material, including for purposes of Section 3(b); and
-c. You must comply with the conditions in Section 3(a) if You Share all or a substantial portion of the contents of the database.
-
-For the avoidance of doubt, this Section 4 supplements and does not replace Your obligations under this Public License where the Licensed Rights include other Copyright and Similar Rights.
-
-Section 5 – Disclaimer of Warranties and Limitation of Liability.
------------------------------------------------------------------
-
-a. **Unless otherwise separately undertaken by the Licensor, to the extent possible, the Licensor offers the Licensed Material as-is and as-available, and makes no representations or warranties of any kind concerning the Licensed Material, whether express, implied, statutory, or other. This includes, without limitation, warranties of title, merchantability, fitness for a particular purpose, non-infringement, absence of latent or other defects, accuracy, or the presence or absence of errors, whether or not known or discoverable. Where disclaimers of warranties are not allowed in full or in part, this disclaimer may not apply to You.**
-b. **To the extent possible, in no event will the Licensor be liable to You on any legal theory (including, without limitation, negligence) or otherwise for any direct, special, indirect, incidental, consequential, punitive, exemplary, or other losses, costs, expenses, or damages arising out of this Public License or use of the Licensed Material, even if the Licensor has been advised of the possibility of such losses, costs, expenses, or damages. Where a limitation of liability is not allowed in full or in part, this limitation may not apply to You.**
-c. The disclaimer of warranties and limitation of liability provided above shall be interpreted in a manner that, to the extent possible, most closely approximates an absolute disclaimer and waiver of all liability.
-
-Section 6 – Term and Termination.
----------------------------------
-
-a. This Public License applies for the term of the Copyright and Similar Rights licensed here. However, if You fail to comply with this Public License, then Your rights under this Public License terminate automatically.
-b. Where Your right to use the Licensed Material has terminated under Section 6(a), it reinstates:
-
-   1. automatically as of the date the violation is cured, provided it is cured within 30 days of Your discovery of the violation; or
-   2. upon express reinstatement by the Licensor.
-
-   For the avoidance of doubt, this Section 6(b) does not affect any right the Licensor may have to seek remedies for Your violations of this Public License.
-
-c. For the avoidance of doubt, the Licensor may also offer the Licensed Material under separate terms or conditions or stop distributing the Licensed Material at any time; however, doing so will not terminate this Public License.
-d. Sections 1, 5, 6, 7, and 8 survive termination of this Public License.
+The **source code** of this project is licensed under the MIT License (see
+``LICENSE.txt`` in the repository root).
 
-Section 7 – Other Terms and Conditions.
----------------------------------------
+This **documentation** is licensed under
+`Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)
+<https://creativecommons.org/licenses/by-nc-sa/4.0/>`_.
 
-a. The Licensor shall not be bound by any additional or different terms or conditions communicated by You unless expressly agreed.
-b. Any arrangements, understandings, or agreements regarding the Licensed Material not stated herein are separate from and independent of the terms and conditions of this Public License.
+.. raw:: html
 
-Section 8 – Interpretation.
----------------------------
+   <p>
+     This work is licensed under
+     <a href="https://creativecommons.org/licenses/by-nc-sa/4.0/">Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International</a>
+     <img src="https://mirrors.creativecommons.org/presskit/icons/cc.svg" alt="" style="max-width:1em;max-height:1em;margin-left:.2em;">
+     <img src="https://mirrors.creativecommons.org/presskit/icons/by.svg" alt="" style="max-width:1em;max-height:1em;margin-left:.2em;">
+     <img src="https://mirrors.creativecommons.org/presskit/icons/nc.svg" alt="" style="max-width:1em;max-height:1em;margin-left:.2em;">
+     <img src="https://mirrors.creativecommons.org/presskit/icons/sa.svg" alt="" style="max-width:1em;max-height:1em;margin-left:.2em;">
+   </p>
 
-a. For the avoidance of doubt, this Public License does not, and shall not be interpreted to, reduce, limit, restrict, or impose conditions on any use of the Licensed Material that could lawfully be made without permission under this Public License.
-b. To the extent possible, if any provision of this Public License is deemed unenforceable, it shall be automatically reformed to the minimum extent necessary to make it enforceable. If the provision cannot be reformed, it shall be severed from this Public License without affecting the enforceability of the remaining terms and conditions.
-c. No term or condition of this Public License will be waived and no failure to comply consented to unless expressly agreed to by the Licensor.
-d. Nothing in this Public License constitutes or may be interpreted as a limitation upon, or waiver of, any privileges and immunities that apply to the Licensor or You, including from the legal processes of any jurisdiction or authority.
+The plain-text original is kept at ``docs/LICENSE.txt``; the formatted text below
+is reproduced from it.
 
-Creative Commons is not a party to its public licenses. Notwithstanding, Creative Commons may elect to apply one of its public licenses to material it publishes and in those instances will be considered the “Licensor.” The text of the Creative Commons public licenses is dedicated to the public domain under the `CC0 Public Domain Dedication <https://creativecommons.org/publicdomain/zero/1.0/legalcode>`_. Except for the limited purpose of indicating that material is shared under a Creative Commons public license or as otherwise permitted by the Creative Commons policies published at `creativecommons.org/policies <https://creativecommons.org/policies>`_, Creative Commons does not authorize the use of the trademark “Creative Commons” or any other trademark or logo of Creative Commons without its prior written consent including, without limitation, in connection with any unauthorized modifications to any of its public licenses or any other arrangements, understandings, or agreements concerning use of licensed material. For the avoidance of doubt, this paragraph does not form part of the public licenses.
+.. note::
 
-Creative Commons may be contacted at `creativecommons.org <https://creativecommons.org/>`_.
+   The license text below is generated by ``docs/update-license.py`` from the
+   official `creativecommons.org legalcode
+   <https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode>`_ (falling back
+   to ``docs/LICENSE.txt`` if offline) — reformatted to reStructuredText, with
+   the wording kept verbatim.
 
-Additional languages available: `العربية <https://creativecommons.org/licenses/by-sa/4.0/legalcode.ar>`_, `čeština <https://creativecommons.org/licenses/by-sa/4.0/legalcode.cs>`_, `Deutsch <https://creativecommons.org/licenses/by-sa/4.0/legalcode.de>`_, `Ελληνικά <https://creativecommons.org/licenses/by-sa/4.0/legalcode.el>`_, `Español <https://creativecommons.org/licenses/by-sa/4.0/legalcode.es>`_, `euskara <https://creativecommons.org/licenses/by-sa/4.0/legalcode.eu>`_, `suomeksi <https://creativecommons.org/licenses/by-sa/4.0/legalcode.fi>`_, `français <https://creativecommons.org/licenses/by-sa/4.0/legalcode.fr>`_, `hrvatski <https://creativecommons.org/licenses/by-sa/4.0/legalcode.hr>`_, `Bahasa Indonesia <https://creativecommons.org/licenses/by-sa/4.0/legalcode.id>`_, `italiano <https://creativecommons.org/licenses/by-sa/4.0/legalcode.it>`_, `日本語 <https://creativecommons.org/licenses/by-sa/4.0/legalcode.ja>`_, `한국어 <https://creativecommons.org/licenses/by-sa/4.0/legalcode.ko>`_, `Lietuvių <https://creativecommons.org/licenses/by-sa/4.0/legalcode.lt>`_, `latviski <https://creativecommons.org/licenses/by-sa/4.0/legalcode.lv>`_, `te reo Māori <https://creativecommons.org/licenses/by-sa/4.0/legalcode.mi>`_, `Nederlands <https://creativecommons.org/licenses/by-sa/4.0/legalcode.nl>`_, `norsk <https://creativecommons.org/licenses/by-sa/4.0/legalcode.no>`_, `polski <https://creativecommons.org/licenses/by-sa/4.0/legalcode.pl>`_, `português <https://creativecommons.org/licenses/by-sa/4.0/legalcode.pt>`_, `română <https://creativecommons.org/licenses/by-sa/4.0/legalcode.ro>`_, `русский <https://creativecommons.org/licenses/by-sa/4.0/legalcode.ru>`_, `Slovenščina <https://creativecommons.org/licenses/by-sa/4.0/legalcode.sl>`_, `svenska <https://creativecommons.org/licenses/by-sa/4.0/legalcode.sv>`_, `Türkçe <https://creativecommons.org/licenses/by-sa/4.0/legalcode.tr>`_, `українська <https://creativecommons.org/licenses/by-sa/4.0/legalcode.uk>`_, `中文 <https://creativecommons.org/licenses/by-sa/4.0/legalcode.zh-Hans>`_, `華語 <https://creativecommons.org/licenses/by-sa/4.0/legalcode.zh-Hant>`_. Please read the `FAQ <https://creativecommons.org/faq/#officialtranslations>`_ for more information about official translations.
+.. include:: ../../LICENSE.rst
diff --git a/docs/source/appendix/faq.rst b/docs/source/appendix/faq.rst
deleted file mode 100644
index 2a9c336..0000000
--- a/docs/source/appendix/faq.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-================================
-FAQ (Frequently Asked Questions)
-================================
-
-Start asking question, or this never gets created.
diff --git a/docs/source/appendix/sponsors.rst b/docs/source/appendix/sponsors.rst
deleted file mode 100644
index b2f19f1..0000000
--- a/docs/source/appendix/sponsors.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-========
-Sponsors
-========
-
-None (yet)
diff --git a/docs/source/conf.py b/docs/source/conf.py
index 0dcbfe9..0c359c9 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -16,9 +16,21 @@
 
 # -- Project information -----------------------------------------------------
 
+import re
+from pathlib import Path
+
 project = 'votifier-client-php'
-copyright = '2020, Manuele Vaccari'
-author = 'Manuele Vaccari'
+
+# Derive the copyright years and holder from LICENSE.txt (single source of
+# truth) so they never have to be hand-updated here.
+_license = (Path(__file__).resolve().parents[2] / 'LICENSE.txt').read_text(encoding='utf-8')
+_match = re.search(r'Copyright \(c\)\s+([0-9][0-9,\-\s]*[0-9])\s+([A-Za-z].*)', _license)
+if _match:
+    _years, author = _match.group(1).strip(), _match.group(2).strip()
+else:  # fall back rather than break the build if the license format changes
+    _years, author = '2015-present', 'Manuele Vaccari'
+
+copyright = f'{_years} {author}'
 
 # The full version, including alpha/beta/rc tags
 # release = 'x.x.x'
@@ -29,7 +41,8 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
-    'sphinxcontrib.phpdomain'
+    'sphinxcontrib.phpdomain',
+    'myst_parser',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -38,7 +51,9 @@
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This pattern also affects html_static_path and html_extra_path.
-exclude_patterns = ['Thumbs.db', '.DS_Store']
+# '_community' is the Team-MaRo/.github submodule — its Markdown files are pulled
+# in via `.. include::`, so exclude them from being built as standalone pages.
+exclude_patterns = ['Thumbs.db', '.DS_Store', '_community']
 
 # The master toctree document.
 master_doc = 'index'
@@ -53,13 +68,7 @@
 #
 html_theme = 'sphinx_rtd_theme'
 
-# Add any paths that contain custom static files (such as style sheets) here,
-# relative to this directory. They are copied after the builtin static files,
-# so a file named "default.css" will overwrite the builtin "default.css".
+# Styles the `:underline:` role used by the generated license (RST has no native
+# underline); see docs/source/_static/css/custom.css.
 html_static_path = ['_static']
-
-# These paths are either relative to html_static_path
-# or fully qualified paths (eg. https://...)
-html_css_files = [
-    'css/custom.css',
-]
+html_css_files = ['css/custom.css']
diff --git a/docs/source/getting-started/prerequisites.rst b/docs/source/getting-started/prerequisites.rst
index febe52a..318ecc1 100644
--- a/docs/source/getting-started/prerequisites.rst
+++ b/docs/source/getting-started/prerequisites.rst
@@ -34,12 +34,20 @@ We can use a Docker container for this
         -e EULA=true \
         d3strukt0r/spigot
 
-And place the latest and desired Votifier Jar that you want. Out of simplicity let's use the classic one.
+Place a Votifier plugin jar in :code:`./spigot/plugins/` and restart the server.
 
-https://dev.bukkit.org/projects/votifier/files/latest
+We recommend **NuVotifier** -- it is maintained, runs on current Java, and speaks both the
+classic Votifier protocol and its own v2 token protocol:
 
-And put it in :code:`./spigot/plugins/`
+- SpigotMC: https://www.spigotmc.org/resources/nuvotifier.13449/
+- GitHub releases: https://github.com/NuVotifier/NuVotifier/releases
 
-After that you can restart the server with the previous command.
+.. warning::
+
+   Avoid the original "classic" vexsoftware Votifier on modern servers: it relies on
+   ``javax.xml.bind.DatatypeConverter`` (removed from the JDK in Java 11), so it only runs
+   on Java 8 -- i.e. Minecraft up to 1.16.5. See :doc:`votifier` for the details. For
+   reference: https://github.com/vexsoftware/votifier and
+   https://www.curseforge.com/minecraft/bukkit-plugins/votifier
 
 Now you have your project with the plugin and a server which runs the votifier plugin.
diff --git a/docs/source/getting-started/votifier.rst b/docs/source/getting-started/votifier.rst
index e11af4f..867dc4b 100644
--- a/docs/source/getting-started/votifier.rst
+++ b/docs/source/getting-started/votifier.rst
@@ -4,6 +4,16 @@ Sending a vote to Votifier
 
 When you have a server which runs the classic Votifier plugin, you can use this code here.
 
+.. warning::
+
+   The classic Votifier plugin relies on ``javax.xml.bind.DatatypeConverter``, which
+   was removed from the JDK in Java 11, so it only runs on Java 8. The newest Minecraft
+   server that still runs on Java 8 is **1.16.5** (1.17 raised the requirement to Java
+   16), which makes 1.16.5 the last version the classic plugin works on. On a newer
+   server it fails to enable with ``NoClassDefFoundError: javax/xml/bind/DatatypeConverter``.
+   Prefer :doc:`NuVotifier <nuvotifier>` — the maintained successor that runs on current
+   Java and is backwards compatible with this classic protocol.
+
 You can place following code wherever you want to set up the vote:
 
 .. code-block:: php
diff --git a/docs/source/index.rst b/docs/source/index.rst
index 067efa0..9049ed6 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -2,7 +2,7 @@
 Votifier Client (PHP) Manual
 ============================
 
-This work is licensed under a `Creative Commons Attribution-ShareAlike 4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`_.
+This work is licensed under `Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International <https://creativecommons.org/licenses/by-nc-sa/4.0/>`_ (see :doc:`appendix/copyright`).
 
 Table of content
 ================
@@ -29,8 +29,6 @@ Table of content
    :numbered: 1
 
    appendix/story
-   appendix/sponsors
-   appendix/faq
    appendix/changelog
    appendix/contributing
    appendix/code-of-conduct
diff --git a/docs/update-license.py b/docs/update-license.py
new file mode 100755
index 0000000..242c812
--- /dev/null
+++ b/docs/update-license.py
@@ -0,0 +1,276 @@
+#!/usr/bin/env python3
+# /// script
+# requires-python = ">=3.8"
+# dependencies = ["beautifulsoup4"]
+# ///
+"""Regenerate docs/LICENSE.rst (CC BY-NC-SA 4.0) for the documentation.
+
+Primary source: the official HTML legalcode on creativecommons.org, converted to
+reStructuredText so the lettered/roman/numbered lists (a. / i. / A. / 1.) render
+natively, with underlined defined terms, bold and hyperlinks preserved.
+
+Fallback: if the site can't be reached, the committed plain-text legalcode
+(docs/LICENSE.txt) is converted instead — same structure and lists, but without
+the underline/bold that only exist in the HTML.
+
+Run:  uv run docs/update-license.py   (RTD runs it in a pre_build job)
+"""
+import re
+import string
+import textwrap
+import urllib.request
+from pathlib import Path
+from urllib.error import URLError
+
+from bs4 import BeautifulSoup, NavigableString
+
+SOURCE_URL = "https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode"
+HERE = Path(__file__).resolve().parent
+OUTPUT = HERE / "LICENSE.rst"
+LICENSE_TXT = HERE / "LICENSE.txt"
+WRAP_WIDTH = 71
+DIVS = ["notice-about-licenses-and-cc", "about-cc-and-license",
+        "legal-code-body", "notice-about-cc-and-trademark"]
+CHROME = {"About the license and Creative Commons", "About Creative Commons"}
+# Heading underline characters, from the license's top level downward (they sit
+# under copyright.rst's "=" title, so they must be distinct from "=").
+HEADING_CHARS = "-~^\""
+
+_ROMAN = [(1000, "m"), (900, "cm"), (500, "d"), (400, "cd"), (100, "c"),
+          (90, "xc"), (50, "l"), (40, "xl"), (10, "x"), (9, "ix"),
+          (5, "v"), (4, "iv"), (1, "i")]
+
+
+def _alpha(idx):
+    out, n = "", idx + 1
+    while n > 0:
+        n, r = divmod(n - 1, 26)
+        out = string.ascii_lowercase[r] + out
+    return out
+
+
+def _roman(idx):
+    n, out = idx + 1, ""
+    for value, sym in _ROMAN:
+        while n >= value:
+            out, n = out + sym, n - value
+    return out
+
+
+def _marker(idx, list_type):
+    # Always lowercase, matching the plain-text legalcode.
+    return {"a": _alpha(idx), "i": _roman(idx)}.get((list_type or "1").lower(), str(idx + 1))
+
+
+def _fix_href(href):
+    if href.startswith("//"):
+        href = "https:" + href
+    elif href.startswith("/"):
+        href = "https://creativecommons.org" + href
+    return re.sub(
+        r"https://wiki\.creativecommons\.org/wiki/Considerations_for_licensors_and_licensees#(Considerations_for_licens\w+)",
+        r"https://wiki.creativecommons.org/\1", href)
+
+
+# ---- HTML -> RST -----------------------------------------------------------
+
+def inline_node(child):
+    """A single inline node (text or element) as an RST string."""
+    if isinstance(child, NavigableString):
+        return str(child)
+    name = child.name
+    if name in ("strong", "b"):
+        text = inline(child).strip()
+        return text.upper() if len(text) > 100 else f"**{text}**"
+    if name in ("em", "i"):
+        return f"*{inline(child).strip()}*"
+    if name == "u" or (name == "span" and "underline" in (child.get("style") or "")):
+        return f":underline:`{inline(child).strip()}`"
+    if name == "a":
+        text, href = inline(child).strip(), child.get("href", "")
+        return text if href.startswith("#") else f"`{text} <{_fix_href(href)}>`__"
+    return inline(child)
+
+
+def inline(node):
+    """Inline content of a node's children as an RST string."""
+    return re.sub(r"\s+", " ", "".join(inline_node(c) for c in node.children))
+
+
+def render_list(ol, indent):
+    items = [c for c in ol.children if getattr(c, "name", None) == "li"]
+    list_type = ol.get("type", "1") if ol.name == "ol" else None
+    blocks = []
+    for idx, li in enumerate(items):
+        marker = "- " if list_type is None else _marker(idx, list_type) + ". "
+        lead, nested = [], []
+        for child in li.children:
+            if getattr(child, "name", None) in ("ol", "ul"):
+                nested.append(child)
+            else:
+                lead.append(inline_node(child))
+        lead_text = re.sub(r"\s+", " ", "".join(lead)).strip()
+        hang = indent + " " * len(marker)
+        out = textwrap.fill(lead_text, WRAP_WIDTH, initial_indent=indent + marker,
+                            subsequent_indent=hang, break_long_words=False,
+                            break_on_hyphens=False)
+        for sub in nested:
+            out += "\n\n" + render_list(sub, hang)
+        blocks.append(out)
+    return "\n\n".join(blocks)
+
+
+def heading(text, level):
+    text = to_ascii(text)  # so the underline length matches the final text
+    return f"{text}\n{HEADING_CHARS[level] * len(text)}"
+
+
+def html_to_rst(html):
+    soup = BeautifulSoup(html, "html.parser")
+    out = []
+    title = None
+    for div_id in DIVS:
+        div = soup.find(id=div_id)
+        if div is None:
+            continue
+        # Walk the div's meaningful blocks in document order.
+        for node in div.descendants:
+            name = getattr(node, "name", None)
+            if name == "h2" and node.get("id") == "legal-code-title":
+                title = inline(node).strip()
+                # The formal "... Public License" heading is only inline text in
+                # the HTML; emit it here (before "By exercising") as a heading.
+                out.append(("formal", f"Creative Commons {title} Public License"))
+            elif name in ("h2",) and inline(node).strip() in CHROME:
+                continue
+            elif name == "h2":
+                out.append(("usingcc", inline(node).strip()))
+            elif name == "h3":
+                out.append(("section", inline(node).strip()))
+            elif name == "p" and node.find_parent("li") is None:
+                out.append(("p", inline(node).strip()))
+            elif name == "ol" and node.find_parent(["ol", "ul"]) is None:
+                out.append(("list", node))
+    return assemble(title, out, source="html")
+
+
+# ---- plain text -> RST (fallback) ------------------------------------------
+
+SEP = re.compile(r"^[=-]{3,}\s*$")
+SECTION = re.compile(r"^Section \d+ -- .+\.$")
+ITEM = re.compile(r"^(\s*)((?:[A-Za-z]|[ivxlcdmIVXLCDM]+|\d+)\.)\s+(.*)$")
+
+
+def txt_to_rst(text):
+    out, title = [], None
+    blocks, cur = [], []
+    for line in text.splitlines():
+        if not line.strip():
+            if cur:
+                blocks.append(cur)
+                cur = []
+        elif SEP.match(line):
+            continue
+        else:
+            cur.append(line)
+    if cur:
+        blocks.append(cur)
+
+    stack = []  # (text_col, rst_indent, marker_width)
+    first = True
+    for block in blocks:
+        joined = " ".join(l.strip() for l in block)
+        if first:
+            title = joined
+            first = False
+            continue
+        if joined == "Using Creative Commons Public Licenses":
+            out.append(("usingcc", joined)); stack = []; continue
+        if joined.startswith("Creative Commons Attribution") and joined.endswith("Public License"):
+            out.append(("formal", joined)); stack = []; continue
+        if len(block) == 1 and SECTION.match(block[0].strip()):
+            out.append(("section", block[0].strip())); stack = []; continue
+        m = ITEM.match(block[0])
+        if m:
+            ws, mark, head = m.groups()
+            text_col = len(ws) + len(mark) + 1
+            body = (head + " " + " ".join(l.strip() for l in block[1:])).strip()
+            body = _linkify(body)
+            while stack and stack[-1][0] > text_col:
+                stack.pop()
+            if stack and stack[-1][0] == text_col:
+                rst_indent = stack[-1][1]; stack.pop()
+            elif stack:
+                rst_indent = stack[-1][1] + stack[-1][2]
+            else:
+                rst_indent = 0
+            mw = len(mark) + 1
+            stack.append((text_col, rst_indent, mw))
+            pad = " " * rst_indent
+            out.append(("li", textwrap.fill(
+                mark + " " + body, WRAP_WIDTH, initial_indent=pad,
+                subsequent_indent=pad + " " * mw,
+                break_long_words=False, break_on_hyphens=False)))
+        else:
+            out.append(("p", _linkify(joined))); stack = []
+    return assemble(title, out, source="txt")
+
+
+def _linkify(text):
+    text = re.sub(r"\b((?:wiki\.)?creativecommons\.org/[A-Za-z0-9/_-]+)",
+                  r"`\1 <https://\1>`__", text)
+    return re.sub(r"(?<![/`])\bcreativecommons\.org\b(?![/`])",
+                  r"`creativecommons.org <https://creativecommons.org>`__", text)
+
+
+# ---- shared assembly -------------------------------------------------------
+
+def assemble(title, items, source):
+    lines = [".. role:: underline", ""]
+    if title:
+        lines += [heading(title, 0), ""]
+    for kind, value in items:
+        if kind == "usingcc":
+            lines += [heading(value, 1), ""]
+        elif kind == "formal":
+            lines += [heading(value, 1), ""]
+        elif kind == "section":
+            lines += [heading(value, 2), ""]
+        elif kind == "p":
+            lines += [textwrap.fill(value, WRAP_WIDTH, break_long_words=False,
+                                    break_on_hyphens=False), ""]
+        elif kind == "li":      # txt fallback: already-rendered RST list block
+            lines += [value, ""]
+        elif kind == "list":    # html: a bs4 <ol>
+            lines += [render_list(value, ""), ""]
+    # For the HTML source, lift the formal "... Public License" heading to sit
+    # before "By exercising" (it's only inline text in the HTML); the txt has it.
+    rst = "\n".join(lines)
+    rst = re.sub(r"\n{3,}", "\n\n", rst).strip() + "\n"
+    return to_ascii(rst)
+
+
+_TYPOGRAPHY = {"“": '"', "”": '"', "‘": "'", "’": "'", "–": "--", "—": "--"}
+
+
+def to_ascii(text):
+    for fancy, plain in _TYPOGRAPHY.items():
+        text = text.replace(fancy, plain)
+    return text
+
+
+def main():
+    try:
+        request = urllib.request.Request(SOURCE_URL, headers={"User-Agent": "Mozilla/5.0"})
+        html = urllib.request.urlopen(request, timeout=30).read().decode("utf-8")
+        rst = html_to_rst(html)
+        src = "official HTML legalcode"
+    except (URLError, OSError) as exc:
+        rst = txt_to_rst(LICENSE_TXT.read_text(encoding="utf-8"))
+        src = f"docs/LICENSE.txt (HTML fetch failed: {exc})"
+    OUTPUT.write_text(rst, encoding="utf-8")
+    print(f"Wrote {OUTPUT} from {src} ({len(rst.splitlines())} lines).")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/phpdoc.dist.xml b/phpdoc.dist.xml
index ab5df68..6f9cf95 100644
--- a/phpdoc.dist.xml
+++ b/phpdoc.dist.xml
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="UTF-8" ?>
-<phpdocumentor 
+<phpdocumentor
     configVersion="3"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xmlns="https://www.phpdoc.org"
-    xsi:noNamespaceSchemaLocation="https://github.com/phpDocumentor/phpDocumentor/blob/v3.0.0-rc/data/xsd/phpdoc.xsd">
+    xsi:noNamespaceSchemaLocation="https://raw.githubusercontent.com/phpDocumentor/phpDocumentor/refs/tags/v3.10.0/data/xsd/phpdoc.xsd">
     <title>Votifier Client</title>
     <paths>
         <output>api</output>
@@ -32,4 +32,4 @@
         </guide>
     </version>
     <template name="default"/>
-</phpdocumentor>
\ No newline at end of file
+</phpdocumentor>

From 9ecb252043ca5427c41a5ba77d79e441e67481a1 Mon Sep 17 00:00:00 2001
From: D3strukt0r <dev@d3strukt0r.dev>
Date: Mon, 29 Jun 2026 22:30:00 +0200
Subject: [PATCH 07/13] test: run the suite across PHPUnit 7 through 13

Migrate the test metadata to PHP attributes while keeping the annotations so the suite runs on PHPUnit 7 to 13 (PHP 7.1 to 8.5), type the mock properties as Socket&Stub intersections so static analysis resolves the stubbed methods, and add a test covering an invalid public key.
---
 tests/Server/GenericServerTypeTest.php |  35 ++---
 tests/Server/NuVotifierTest.php        | 198 ++++++++++++-------------
 tests/Server/VotifierTest.php          | 152 ++++++++++---------
 tests/Vote/ClassicVoteTest.php         |  24 ++-
 4 files changed, 203 insertions(+), 206 deletions(-)

diff --git a/tests/Server/GenericServerTypeTest.php b/tests/Server/GenericServerTypeTest.php
index 7a50e27..781bb5a 100644
--- a/tests/Server/GenericServerTypeTest.php
+++ b/tests/Server/GenericServerTypeTest.php
@@ -3,11 +3,11 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client\Server;
@@ -16,13 +16,10 @@
 use D3strukt0r\Votifier\Client\Vote\VoteInterface;
 use PHPUnit\Framework\TestCase;
 
-use const DIRECTORY_SEPARATOR;
-
 /**
  * Class GenericServerTypeTest.
  *
  * @covers \D3strukt0r\Votifier\Client\Server\GenericServer
- *
  * @internal
  */
 final class GenericServerTypeTest extends TestCase
@@ -34,14 +31,12 @@ final class GenericServerTypeTest extends TestCase
 
     protected function setUp(): void
     {
-        $this->object = new class () extends GenericServer {
-            public function verifyConnection(): void
-            {
-            }
+        $this->object = new class extends GenericServer {
+            public function verifyConnection(): void {}
 
             public function sendVote(VoteInterface ...$votes): void
             {
-                if (null !== $votes) {
+                if ($votes !== null) {
                     return;
                 }
             }
@@ -55,32 +50,32 @@ protected function tearDown(): void
 
     public function testInstanceOf(): void
     {
-        $this->assertInstanceOf('D3strukt0r\Votifier\Client\Server\GenericServer', $this->object);
+        self::assertInstanceOf('D3strukt0r\Votifier\Client\Server\GenericServer', $this->object);
     }
 
     public function testSocket(): void
     {
         $socket = new Socket();
         $this->object->setSocket($socket);
-        $this->assertSame($socket, $this->object->getSocket());
+        self::assertSame($socket, $this->object->getSocket());
     }
 
     public function testHost(): void
     {
         $this->object->setHost('mock_host');
-        $this->assertSame('mock_host', $this->object->getHost());
+        self::assertSame('mock_host', $this->object->getHost());
     }
 
     public function testPort(): void
     {
         $this->object->setPort(1);
-        $this->assertSame(1, $this->object->getPort());
+        self::assertSame(1, $this->object->getPort());
     }
 
     public function testPublicKey(): void
     {
-        $key = file_get_contents(__DIR__ . DIRECTORY_SEPARATOR . 'votifier_public.key');
-        $keyFormatted = wordwrap($key, 65, "\n", true);
+        $key = file_get_contents(__DIR__.\DIRECTORY_SEPARATOR.'votifier_public.key');
+        $keyFormatted = wordwrap($key, 64, "\n", true);
         $keyFormatted = <<<EOF
 -----BEGIN PUBLIC KEY-----
 {$keyFormatted}
@@ -88,6 +83,6 @@ public function testPublicKey(): void
 EOF;
 
         $this->object->setPublicKey($key);
-        $this->assertSame($keyFormatted, $this->object->getPublicKey());
+        self::assertSame($keyFormatted, $this->object->getPublicKey());
     }
 }
diff --git a/tests/Server/NuVotifierTest.php b/tests/Server/NuVotifierTest.php
index 8358e2d..7e19322 100644
--- a/tests/Server/NuVotifierTest.php
+++ b/tests/Server/NuVotifierTest.php
@@ -3,11 +3,11 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client\Server;
@@ -23,28 +23,26 @@
 use D3strukt0r\Votifier\Client\Socket;
 use D3strukt0r\Votifier\Client\Vote\ClassicVote;
 use D3strukt0r\Votifier\Client\Vote\VoteInterface;
-use DateTime;
-use InvalidArgumentException;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\DataProvider;
+use PHPUnit\Framework\Attributes\RequiresPhpunit;
 use PHPUnit\Framework\MockObject\Stub;
 use PHPUnit\Framework\TestCase;
 
-use function file_get_contents;
-
-use const DIRECTORY_SEPARATOR;
-
 /**
  * Class NuVotifierTest.
  *
  * @requires PHPUnit >= 8
  *
  * @covers   \D3strukt0r\Votifier\Client\Server\NuVotifier
- *
  * @internal
  */
+#[RequiresPhpunit('>= 8.0.0')]
+#[CoversClass(NuVotifier::class)]
 final class NuVotifierTest extends TestCase
 {
     /**
-     * @var Socket|Stub The Socket tool class
+     * @var Socket&Stub The Socket tool class
      */
     private $socketStub;
 
@@ -65,8 +63,8 @@ final class NuVotifierTest extends TestCase
 
     protected function setUp(): void
     {
-        $this->socketStub = $this->createStub(Socket::class);
-        $key = file_get_contents(__DIR__ . DIRECTORY_SEPARATOR . 'votifier_public.key');
+        $this->socketStub = self::createStub(Socket::class);
+        $key = file_get_contents(__DIR__.\DIRECTORY_SEPARATOR.'votifier_public.key');
         $this->nuvotifier = (new NuVotifier())
             ->setSocket($this->socketStub)
             ->setHost('mock_host')
@@ -96,27 +94,26 @@ protected function tearDown(): void
 
     public function testInstanceOf(): void
     {
-        $this->assertInstanceOf('D3strukt0r\Votifier\Client\Server\NuVotifier', $this->nuvotifier);
+        self::assertInstanceOf('D3strukt0r\Votifier\Client\Server\NuVotifier', $this->nuvotifier);
     }
 
     public function testProtocolV2(): void
     {
         $this->nuvotifier->setProtocolV2(true);
-        $this->assertTrue($this->nuvotifier->isProtocolV2());
+        self::assertTrue($this->nuvotifier->isProtocolV2());
     }
 
     public function testToken(): void
     {
         $this->nuvotifier->setToken('mock_token');
-        $this->assertSame('mock_token', $this->nuvotifier->getToken());
+        self::assertSame('mock_token', $this->nuvotifier->getToken());
     }
 
     /**
-     * @param $readString
-     *
      * @dataProvider notVotifierExceptionProvider
      */
-    public function testVerifyConnection($readString): void
+    #[DataProvider('notVotifierExceptionProvider')]
+    public function testVerifyConnection(string $readString): void
     {
         $this->socketStub
             ->method('read')
@@ -134,7 +131,7 @@ public function testVerifyConnectionSuccess(): void
             ->willReturn('VOTIFIER 2 mock_challenge')
         ;
 
-        $this->assertNull($this->nuvotifier->verifyConnection());
+        self::assertNull($this->nuvotifier->verifyConnection());
     }
 
     public function testSendV1(): void
@@ -144,10 +141,25 @@ public function testSendV1(): void
             ->willReturn('VOTIFIER 2 mock_challenge')
         ;
 
-        $this->assertNull($this->nuvotifier->sendVote($this->vote));
+        self::assertNull($this->nuvotifier->sendVote($this->vote));
+    }
+
+    /**
+     * @dataProvider notVotifierExceptionProvider
+     */
+    #[DataProvider('notVotifierExceptionProvider')]
+    public function testNotVotifierException(string $readString): void
+    {
+        $this->socketStub
+            ->method('read')
+            ->willReturn($readString)
+        ;
+
+        $this->expectException(NotVotifierException::class);
+        $this->nuvotifierV2->sendVote($this->vote);
     }
 
-    public function notVotifierExceptionProvider(): array
+    public static function notVotifierExceptionProvider(): iterable
     {
         return [
             'absolutely not votifier' => ['SOMETHING_WEIRD'],
@@ -157,22 +169,37 @@ public function notVotifierExceptionProvider(): array
     }
 
     /**
-     * @param $readString
-     *
-     * @dataProvider notVotifierExceptionProvider
+     * @dataProvider checkRequiredVariablesForPackageProvider
      */
-    public function testNotVotifierException($readString): void
+    #[DataProvider('checkRequiredVariablesForPackageProvider')]
+    public function testCheckRequiredVariablesForPackage(?string $serviceName, ?string $username, ?string $address, ?int $timestamp, ?string $token): void
     {
         $this->socketStub
             ->method('read')
-            ->willReturn($readString)
+            ->willReturn('VOTIFIER 2 mock_challenge')
         ;
 
-        $this->expectException(NotVotifierException::class);
-        $this->nuvotifierV2->sendVote($this->vote);
+        $nuvotifierV2 = (new NuVotifier())
+            ->setSocket($this->socketStub)
+            ->setHost('mock_host')
+            ->setPort(0)
+            ->setProtocolV2(true)
+        ;
+        if ($token !== null) {
+            $nuvotifierV2->setToken($token);
+        }
+
+        $voteStub = self::createStub(ClassicVote::class);
+        $voteStub->method('getServiceName')->willReturn($serviceName);
+        $voteStub->method('getUsername')->willReturn($username);
+        $voteStub->method('getAddress')->willReturn($address);
+        $voteStub->method('getTimestamp')->willReturn($timestamp);
+
+        $this->expectException(\InvalidArgumentException::class);
+        $nuvotifierV2->sendVote($voteStub);
     }
 
-    public function checkRequiredVariablesForPackageProvider(): array
+    public static function checkRequiredVariablesForPackageProvider(): iterable
     {
         return [
             'nothing set' => [
@@ -221,7 +248,7 @@ public function checkRequiredVariablesForPackageProvider(): array
                 null,
                 null,
                 null,
-                (new DateTime())->getTimestamp(),
+                (new \DateTime())->getTimestamp(),
                 null,
             ],
             'only token' => [
@@ -234,42 +261,6 @@ public function checkRequiredVariablesForPackageProvider(): array
         ];
     }
 
-    /**
-     * @param $serviceName
-     * @param $username
-     * @param $address
-     * @param $timestamp
-     * @param $token
-     *
-     * @dataProvider checkRequiredVariablesForPackageProvider
-     */
-    public function testCheckRequiredVariablesForPackage($serviceName, $username, $address, $timestamp, $token): void
-    {
-        $this->socketStub
-            ->method('read')
-            ->willReturn('VOTIFIER 2 mock_challenge')
-        ;
-
-        $nuvotifierV2 = (new NuVotifier())
-            ->setSocket($this->socketStub)
-            ->setHost('mock_host')
-            ->setPort(0)
-            ->setProtocolV2(true)
-        ;
-        if (null !== $token) {
-            $nuvotifierV2->setToken($token);
-        }
-
-        $voteStub = $this->createStub(ClassicVote::class);
-        $voteStub->method('getServiceName')->willReturn($serviceName);
-        $voteStub->method('getUsername')->willReturn($username);
-        $voteStub->method('getAddress')->willReturn($address);
-        $voteStub->method('getTimestamp')->willReturn($timestamp);
-
-        $this->expectException(InvalidArgumentException::class);
-        $nuvotifierV2->sendVote($voteStub);
-    }
-
     public function testPackageNotSentException(): void
     {
         $this->socketStub
@@ -287,21 +278,42 @@ public function testPackageNotSentException(): void
 
     public function testPackageNotReceivedException(): void
     {
+        $read = 0;
         $this->socketStub
             ->method('read')
-            ->will(
-                $this->onConsecutiveCalls(
-                    'VOTIFIER 2 mock_challenge',
-                    $this->throwException(new PackageNotReceivedException())
-                )
-            )
+            ->willReturnCallback(static function () use (&$read) {
+                if ($read++ === 0) {
+                    return 'VOTIFIER 2 mock_challenge';
+                }
+
+                throw new PackageNotReceivedException();
+            })
         ;
 
         $this->expectException(PackageNotReceivedException::class);
         $this->nuvotifierV2->sendVote($this->vote);
     }
 
-    public function nuVotifierResponseAfterSendVoteProvider(): array
+    /**
+     * @dataProvider nuVotifierResponseAfterSendVoteProvider
+     */
+    #[DataProvider('nuVotifierResponseAfterSendVoteProvider')]
+    public function testNuVotifierResponseAfterSendVote(string $errorMessage, string $exceptionClass): void
+    {
+        $reads = ['VOTIFIER 2 mock_challenge', $errorMessage];
+        $read = 0;
+        $this->socketStub
+            ->method('read')
+            ->willReturnCallback(static function () use (&$read, $reads) {
+                return $reads[$read++];
+            })
+        ;
+
+        $this->expectException($exceptionClass);
+        $this->nuvotifierV2->sendVote($this->vote);
+    }
+
+    public static function nuVotifierResponseAfterSendVoteProvider(): iterable
     {
         return [
             'challenge invalid' => [
@@ -313,8 +325,8 @@ public function nuVotifierResponseAfterSendVoteProvider(): array
                 NuVotifierUnknownServiceException::class,
             ],
             'signature invalid' => [
-                '{"status":"error","cause":"CorruptedFrameException",' .
-                '"error":"Signature is not valid (invalid token?)"}',
+                '{"status":"error","cause":"CorruptedFrameException",'
+                .'"error":"Signature is not valid (invalid token?)"}',
                 NuVotifierSignatureInvalidException::class,
             ],
             'username too long' => [
@@ -328,35 +340,17 @@ public function nuVotifierResponseAfterSendVoteProvider(): array
         ];
     }
 
-    /**
-     * @param $errorMessage
-     * @param $exceptionClass
-     *
-     * @dataProvider nuVotifierResponseAfterSendVoteProvider
-     */
-    public function testNuVotifierResponseAfterSendVote($errorMessage, $exceptionClass): void
-    {
-        $this->socketStub
-            ->method('read')
-            ->will(
-                $this->onConsecutiveCalls(
-                    'VOTIFIER 2 mock_challenge',
-                    $errorMessage
-                )
-            )
-        ;
-
-        $this->expectException($exceptionClass);
-        $this->nuvotifierV2->sendVote($this->vote);
-    }
-
     public function testSend(): void
     {
+        $reads = ['VOTIFIER 2 mock_challenge', '{"status":"ok"}'];
+        $read = 0;
         $this->socketStub
             ->method('read')
-            ->will($this->onConsecutiveCalls('VOTIFIER 2 mock_challenge', '{"status":"ok"}'))
+            ->willReturnCallback(static function () use (&$read, $reads) {
+                return $reads[$read++];
+            })
         ;
 
-        $this->assertNull($this->nuvotifierV2->sendVote($this->vote));
+        self::assertNull($this->nuvotifierV2->sendVote($this->vote));
     }
 }
diff --git a/tests/Server/VotifierTest.php b/tests/Server/VotifierTest.php
index f839f5d..64f035a 100644
--- a/tests/Server/VotifierTest.php
+++ b/tests/Server/VotifierTest.php
@@ -3,11 +3,11 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client\Server;
@@ -18,27 +18,26 @@
 use D3strukt0r\Votifier\Client\Socket;
 use D3strukt0r\Votifier\Client\Vote\ClassicVote;
 use D3strukt0r\Votifier\Client\Vote\VoteInterface;
-use DateTime;
-use InvalidArgumentException;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\DataProvider;
+use PHPUnit\Framework\Attributes\RequiresPhpunit;
+use PHPUnit\Framework\MockObject\Stub;
 use PHPUnit\Framework\TestCase;
 
-use function file_get_contents;
-
-use const DIRECTORY_SEPARATOR;
-
 /**
  * Class VotifierTest.
  *
  * @requires PHPUnit >= 8
  *
  * @covers   \D3strukt0r\Votifier\Client\Server\Votifier
- *
  * @internal
  */
+#[RequiresPhpunit('>= 8.0.0')]
+#[CoversClass(Votifier::class)]
 final class VotifierTest extends TestCase
 {
     /**
-     * @var Socket The Socket tool class
+     * @var Socket&Stub The Socket tool class
      */
     private $socketStub;
 
@@ -54,12 +53,12 @@ final class VotifierTest extends TestCase
 
     protected function setUp(): void
     {
-        $this->socketStub = $this->createStub(Socket::class);
+        $this->socketStub = self::createStub(Socket::class);
         $this->votifier = (new Votifier())
             ->setSocket($this->socketStub)
             ->setHost('mock_host')
             ->setPort(0)
-            ->setPublicKey(file_get_contents(__DIR__ . DIRECTORY_SEPARATOR . 'votifier_public.key'))
+            ->setPublicKey(file_get_contents(__DIR__.\DIRECTORY_SEPARATOR.'votifier_public.key'))
         ;
         $this->vote = (new ClassicVote())
             ->setServiceName('mock_service_name')
@@ -76,7 +75,7 @@ protected function tearDown(): void
 
     public function testInstanceOf(): void
     {
-        $this->assertInstanceOf('D3strukt0r\Votifier\Client\Server\Votifier', $this->votifier);
+        self::assertInstanceOf('D3strukt0r\Votifier\Client\Server\Votifier', $this->votifier);
     }
 
     public function testVerifyConnection(): void
@@ -97,38 +96,36 @@ public function testVerifyConnectionSuccess(): void
             ->willReturn('VOTIFIER')
         ;
 
-        $this->assertNull($this->votifier->verifyConnection());
-    }
-
-    public function checkRequiredVariablesForSocketProvider(): array
-    {
-        return [
-            'nothing set' => [null, null],
-            // 'only host set' => ['mock_host', null], // Doesn't work, port is set by default
-            'only port set' => [null, 0],
-        ];
+        self::assertNull($this->votifier->verifyConnection());
     }
 
     /**
-     * @param $host
-     * @param $port
-     *
      * @dataProvider checkRequiredVariablesForSocketProvider
      */
-    public function testCheckRequiredVariablesForSocket($host, $port): void
+    #[DataProvider('checkRequiredVariablesForSocketProvider')]
+    public function testCheckRequiredVariablesForSocket(?string $host, ?int $port): void
     {
         $votifier = new Votifier();
-        if (null !== $host) {
+        if ($host !== null) {
             $votifier->setHost($host);
         }
-        if (null !== $port) {
+        if ($port !== null) {
             $votifier->setPort($port);
         }
 
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(\InvalidArgumentException::class);
         $votifier->sendVote($this->vote);
     }
 
+    public static function checkRequiredVariablesForSocketProvider(): iterable
+    {
+        return [
+            'nothing set' => [null, null],
+            // 'only host set' => ['mock_host', null], // Doesn't work, port is set by default
+            'only port set' => [null, 0],
+        ];
+    }
+
     public function testNoConnectionException(): void
     {
         $this->socketStub
@@ -151,7 +148,37 @@ public function testNotVotifierException(): void
         $this->votifier->sendVote($this->vote);
     }
 
-    public function checkRequiredVariablesForPackageProvider(): array
+    /**
+     * @dataProvider checkRequiredVariablesForPackageProvider
+     */
+    #[DataProvider('checkRequiredVariablesForPackageProvider')]
+    public function testCheckRequiredVariablesForPackage(?string $serviceName, ?string $username, ?string $address, ?int $timestamp, ?string $key): void
+    {
+        $this->socketStub
+            ->method('read')
+            ->willReturn('VOTIFIER 1.9')
+        ;
+
+        $votifier = (new Votifier())
+            ->setSocket($this->socketStub)
+            ->setHost('mock_host')
+            ->setPort(0)
+        ;
+        if ($key !== null) {
+            $votifier->setPublicKey($key);
+        }
+
+        $voteStub = self::createStub(ClassicVote::class);
+        $voteStub->method('getServiceName')->willReturn($serviceName);
+        $voteStub->method('getUsername')->willReturn($username);
+        $voteStub->method('getAddress')->willReturn($address);
+        $voteStub->method('getTimestamp')->willReturn($timestamp);
+
+        $this->expectException(\InvalidArgumentException::class);
+        $votifier->sendVote($voteStub);
+    }
+
+    public static function checkRequiredVariablesForPackageProvider(): iterable
     {
         return [
             'nothing set' => [
@@ -193,7 +220,7 @@ public function checkRequiredVariablesForPackageProvider(): array
                 null,
                 null,
                 null,
-                (new DateTime())->getTimestamp(),
+                (new \DateTime())->getTimestamp(),
                 null,
             ],
             'only key' => [
@@ -201,68 +228,51 @@ public function checkRequiredVariablesForPackageProvider(): array
                 null,
                 null,
                 null,
-                file_get_contents(__DIR__ . DIRECTORY_SEPARATOR . 'votifier_public.key'),
+                file_get_contents(__DIR__.\DIRECTORY_SEPARATOR.'votifier_public.key'),
             ],
         ];
     }
 
-    /**
-     * @param $serviceName
-     * @param $username
-     * @param $address
-     * @param $timestamp
-     * @param $key
-     *
-     * @dataProvider checkRequiredVariablesForPackageProvider
-     */
-    public function testCheckRequiredVariablesForPackage($serviceName, $username, $address, $timestamp, $key): void
+    public function testPackageNotSentException(): void
     {
         $this->socketStub
             ->method('read')
             ->willReturn('VOTIFIER 1.9')
         ;
-
-        $votifier = (new Votifier())
-            ->setSocket($this->socketStub)
-            ->setHost('mock_host')
-            ->setPort(0)
+        $this->socketStub
+            ->method('write')
+            ->willThrowException(new PackageNotSentException())
         ;
-        if (null !== $key) {
-            $votifier->setPublicKey($key);
-        }
 
-        $voteStub = $this->createStub(ClassicVote::class);
-        $voteStub->method('getServiceName')->willReturn($serviceName);
-        $voteStub->method('getUsername')->willReturn($username);
-        $voteStub->method('getAddress')->willReturn($address);
-        $voteStub->method('getTimestamp')->willReturn($timestamp);
-
-        $this->expectException(InvalidArgumentException::class);
-        $votifier->sendVote($voteStub);
+        $this->expectException(PackageNotSentException::class);
+        $this->votifier->sendVote($this->vote);
     }
 
-    public function testPackageNotSentException(): void
+    public function testSend(): void
     {
         $this->socketStub
             ->method('read')
             ->willReturn('VOTIFIER 1.9')
         ;
-        $this->socketStub
-            ->method('write')
-            ->willThrowException(new PackageNotSentException())
-        ;
 
-        $this->expectException(PackageNotSentException::class);
-        $this->votifier->sendVote($this->vote);
+        self::assertNull($this->votifier->sendVote($this->vote));
     }
 
-    public function testSend(): void
+    public function testInvalidPublicKey(): void
     {
         $this->socketStub
             ->method('read')
             ->willReturn('VOTIFIER 1.9')
         ;
 
-        $this->assertNull($this->votifier->sendVote($this->vote));
+        $votifier = (new Votifier())
+            ->setSocket($this->socketStub)
+            ->setHost('mock_host')
+            ->setPort(0)
+            ->setPublicKey('not a valid public key')
+        ;
+
+        $this->expectException(\InvalidArgumentException::class);
+        $votifier->sendVote($this->vote);
     }
 }
diff --git a/tests/Vote/ClassicVoteTest.php b/tests/Vote/ClassicVoteTest.php
index c50562d..9861fbf 100644
--- a/tests/Vote/ClassicVoteTest.php
+++ b/tests/Vote/ClassicVoteTest.php
@@ -3,23 +3,21 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client\Vote;
 
-use DateTime;
 use PHPUnit\Framework\TestCase;
 
 /**
  * Class ClassicVoteTest.
  *
  * @covers \D3strukt0r\Votifier\Client\Vote\ClassicVote
- *
  * @internal
  */
 final class ClassicVoteTest extends TestCase
@@ -41,31 +39,31 @@ protected function tearDown(): void
 
     public function testInstanceOf(): void
     {
-        $this->assertInstanceOf('D3strukt0r\Votifier\Client\Vote\ClassicVote', $this->object);
+        self::assertInstanceOf('D3strukt0r\Votifier\Client\Vote\ClassicVote', $this->object);
     }
 
     public function testUsername(): void
     {
         $this->object->setUsername('mock_user');
-        $this->assertSame('mock_user', $this->object->getUsername());
+        self::assertSame('mock_user', $this->object->getUsername());
     }
 
     public function testServiceName(): void
     {
         $this->object->setServiceName('mock_service');
-        $this->assertSame('mock_service', $this->object->getServiceName());
+        self::assertSame('mock_service', $this->object->getServiceName());
     }
 
     public function testAddress(): void
     {
         $this->object->setAddress('mock_address');
-        $this->assertSame('mock_address', $this->object->getAddress());
+        self::assertSame('mock_address', $this->object->getAddress());
     }
 
     public function testTimestamp(): void
     {
-        $time = new DateTime();
+        $time = new \DateTime();
         $this->object->setTimestamp($time);
-        $this->assertSame($time->getTimestamp(), $this->object->getTimestamp());
+        self::assertSame($time->getTimestamp(), $this->object->getTimestamp());
     }
 }

From 0d2ca72041375aafb4b7d1bc25fe4148ba72b2f7 Mon Sep 17 00:00:00 2001
From: D3strukt0r <dev@d3strukt0r.dev>
Date: Mon, 29 Jun 2026 22:35:00 +0200
Subject: [PATCH 08/13] ci: rename the CI workflow and PHP-CS-Fixer config to
 their new filenames

Move .github/workflows/ci-cd.yml to ci.yml and .php_cs.dist to .php-cs-fixer.dist.php with their contents unchanged, so the history records a rename; the rebuilt pipeline and v3 config land in the following commit.
---
 .github/workflows/{ci-cd.yml => ci.yml} | 0
 .php_cs.dist => .php-cs-fixer.dist.php  | 0
 2 files changed, 0 insertions(+), 0 deletions(-)
 rename .github/workflows/{ci-cd.yml => ci.yml} (100%)
 rename .php_cs.dist => .php-cs-fixer.dist.php (100%)

diff --git a/.github/workflows/ci-cd.yml b/.github/workflows/ci.yml
similarity index 100%
rename from .github/workflows/ci-cd.yml
rename to .github/workflows/ci.yml
diff --git a/.php_cs.dist b/.php-cs-fixer.dist.php
similarity index 100%
rename from .php_cs.dist
rename to .php-cs-fixer.dist.php

From 8aa9e968573e1850c29a551038285d08deacb354 Mon Sep 17 00:00:00 2001
From: D3strukt0r <dev@d3strukt0r.dev>
Date: Mon, 29 Jun 2026 22:40:00 +0200
Subject: [PATCH 09/13] ci: rebuild the CI pipeline and code-quality tooling

Split the workflow into a style/compatibility job on a modern PHP and a PHP 7.1 to 8.5 test matrix, reduce PHP_CodeSniffer to the PHPCompatibility gate while PHP-CS-Fixer owns style, add PHPStan at level 6 with a baseline, drive coverage from the CLI so the config stays valid across PHPUnit versions, and adopt release-please for releases.
---
 .github/CODEOWNERS                         |  15 ++
 .github/FUNDING.yml                        |  12 --
 .github/ISSUE_TEMPLATE/bug-report.md       |  40 -----
 .github/ISSUE_TEMPLATE/feature-request.md  |  19 ---
 .github/dependabot.yml                     |  53 ++++++
 .github/labeler.yml                        |  49 ++++--
 .github/release-please-config.json         |  18 ++
 .github/release-please-manifest.json       |   3 +
 .github/scripts/summarize-step.sh          |  49 ++++++
 .github/workflows/ci.yml                   | 182 ++++++++++++++-------
 .github/workflows/dependabot-automerge.yml |  51 ++++++
 .github/workflows/dependabot-validate.yml  |  35 ++++
 .github/workflows/greetings.yml            |  24 ++-
 .github/workflows/label.yml                |  16 +-
 .github/workflows/stale.yml                |  57 ++-----
 .php-cs-fixer.dist.php                     | 108 ++++++------
 .phpcs.xml                                 |   7 +-
 CHANGELOG.md                               | 126 ++++++++++++++
 phpstan-baseline.neon                      | 121 ++++++++++++++
 phpstan.dist.neon                          |   9 +
 phpunit.xml.dist                           |  16 +-
 21 files changed, 754 insertions(+), 256 deletions(-)
 create mode 100644 .github/CODEOWNERS
 delete mode 100644 .github/FUNDING.yml
 delete mode 100644 .github/ISSUE_TEMPLATE/bug-report.md
 delete mode 100644 .github/ISSUE_TEMPLATE/feature-request.md
 create mode 100644 .github/dependabot.yml
 create mode 100644 .github/release-please-config.json
 create mode 100644 .github/release-please-manifest.json
 create mode 100644 .github/scripts/summarize-step.sh
 create mode 100644 .github/workflows/dependabot-automerge.yml
 create mode 100644 .github/workflows/dependabot-validate.yml
 create mode 100644 CHANGELOG.md
 create mode 100644 phpstan-baseline.neon
 create mode 100644 phpstan.dist.neon

diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
new file mode 100644
index 0000000..d1ecb90
--- /dev/null
+++ b/.github/CODEOWNERS
@@ -0,0 +1,15 @@
+# https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/about-code-owners
+# Last matching pattern wins. Only ONE listed owner needs to approve, not all.
+
+# Default owner for everything.
+* @D3strukt0r
+
+# Files Dependabot manages — @Team-MaRo/CI (incl. the bot user) can also review,
+# so the bot's auto-approval satisfies the code-owner requirement on these paths.
+# composer
+/composer.json @D3strukt0r @Team-MaRo/CI
+/composer.lock @D3strukt0r @Team-MaRo/CI
+# github-actions
+/.github/workflows/ @D3strukt0r @Team-MaRo/CI
+# devcontainers
+/.devcontainer/ @D3strukt0r @Team-MaRo/CI
diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
deleted file mode 100644
index b0ce08b..0000000
--- a/.github/FUNDING.yml
+++ /dev/null
@@ -1,12 +0,0 @@
-# These are supported funding model platforms
-
-github: [D3strukt0r] # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
-patreon: d3strukt0r # Replace with a single Patreon username
-#open_collective: # Replace with a single Open Collective username
-#ko_fi: # Replace with a single Ko-fi username
-#tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
-#community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
-#liberapay: # Replace with a single Liberapay username
-#issuehunt: # Replace with a single IssueHunt username
-#otechie: # Replace with a single Otechie username
-#custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']
diff --git a/.github/ISSUE_TEMPLATE/bug-report.md b/.github/ISSUE_TEMPLATE/bug-report.md
deleted file mode 100644
index aec2414..0000000
--- a/.github/ISSUE_TEMPLATE/bug-report.md
+++ /dev/null
@@ -1,40 +0,0 @@
----
-name: Bug report
-about: Create a report to help us improve
-title: ""
-labels: ""
-assignees: ""
----
-
-**Describe the bug**
-A clear and concise description of what the bug is.
-
-**To Reproduce**
-Steps to reproduce the behavior:
-
-1.  Go to '...'
-2.  Click on '....'
-3.  Scroll down to '....'
-4.  See error
-
-**Expected behavior**
-A clear and concise description of what you expected to happen.
-
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
-
-**Desktop (please complete the following information):**
-
--   OS: (e.g. iOS)
--   Browser (e.g. chrome, safari)
--   Version (e.g. 22)
-
-**Smartphone (please complete the following information):**
-
--   Device: (e.g. iPhone6)
--   OS: (e.g. iOS8.1)
--   Browser (e.g. stock browser, safari)
--   Version (e.g. 22)
-
-**Additional context**
-Add any other context about the problem here.
diff --git a/.github/ISSUE_TEMPLATE/feature-request.md b/.github/ISSUE_TEMPLATE/feature-request.md
deleted file mode 100644
index 966f340..0000000
--- a/.github/ISSUE_TEMPLATE/feature-request.md
+++ /dev/null
@@ -1,19 +0,0 @@
----
-name: Feature request
-about: Suggest an idea for this project
-title: ""
-labels: ""
-assignees: ""
----
-
-**Is your feature request related to a problem? Please describe.**
-A clear and concise description of what the problem is. Ex. I'm always frustrated when '...'
-
-**Describe the solution you'd like**
-A clear and concise description of what you want to happen.
-
-**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
-
-**Additional context**
-Add any other context or screenshots about the feature request here.
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
new file mode 100644
index 0000000..aaf9220
--- /dev/null
+++ b/.github/dependabot.yml
@@ -0,0 +1,53 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+# Note: unique combination of 'package-ecosystem', 'directory', and 'target-branch'
+
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    target-branch: develop
+    labels:
+      - "dependabot :robot:"
+    schedule:
+      interval: weekly
+      day: monday
+      time: '09:30'
+      timezone: Europe/Zurich
+    groups:
+      github-actions:
+        patterns:
+          - "*"
+
+  - package-ecosystem: composer
+    directory: /
+    target-branch: develop
+    labels:
+      - "dependabot :robot:"
+    schedule:
+      interval: weekly
+      day: monday
+      time: '09:30'
+      timezone: Europe/Zurich
+    groups:
+      composer:
+        patterns:
+          - "*"
+
+  - package-ecosystem: docker
+    directory: /
+    target-branch: develop
+    labels:
+      - "dependabot :robot:"
+    schedule:
+      interval: weekly
+      day: monday
+      time: '09:30'
+      timezone: Europe/Zurich
+    groups:
+      docker:
+        patterns:
+          - "*"
diff --git a/.github/labeler.yml b/.github/labeler.yml
index 33ffce2..82bf7ff 100644
--- a/.github/labeler.yml
+++ b/.github/labeler.yml
@@ -1,17 +1,46 @@
-# Add 'repo' label to any root file changes
+# actions/labeler@v6 configuration — every rule uses the `changed-files` /
+# `any-glob-to-any-file` syntax required by v5+.
+
+# Add 'repo' label to any root file change
 repo:
-  - ./*
+  - changed-files:
+      - any-glob-to-any-file: '*'
 
-# Add 'documentation' label to any change to files within the docs dir
+# Add 'documentation' label to docs, the Read the Docs config and any Markdown
 documentation:
-  - docs/**/*
-  - .readthedocs.yml
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'docs/**/*'
+          - '.readthedocs.yml'
+          - '**/*.md'
 
-# Add 'source' label to any change to files within the source dir
+# Add 'source' label to the library and e2e server source
 source:
-  - src/**/*
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'src/**/*'
+          - 'public/**/*'
 
-# Add 'test' label to any change to files within the test dir
+# Add 'test' label to test files and PHPUnit config
 test:
-  - tests/**/*
-  - phpunit.xml.dist
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'tests/**/*'
+          - 'phpunit.xml.dist'
+
+# Add 'docker' label to container files
+docker:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'Dockerfile'
+          - 'compose.yml'
+
+# Add 'feature' label to feature branches
+feature:
+  - head-branch: ['^feature', 'feature']
+
+# Add 'release' label to release PRs targeting master
+release:
+  - all:
+      - base-branch: 'master'
+      - head-branch: ['^release', 'release']
diff --git a/.github/release-please-config.json b/.github/release-please-config.json
new file mode 100644
index 0000000..0ea619d
--- /dev/null
+++ b/.github/release-please-config.json
@@ -0,0 +1,18 @@
+{
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
+  "release-type": "php",
+  "include-v-in-tag": false,
+  "include-component-in-tag": false,
+  "changelog-sections": [
+    { "type": "feat", "section": "✨ Features" },
+    { "type": "fix", "section": "🐛 Bug Fixes" },
+    { "type": "perf", "section": "⚡ Performance" },
+    { "type": "refactor", "section": "♻️ Refactoring", "hidden": false },
+    { "type": "docs", "section": "📚 Documentation", "hidden": false },
+    { "type": "chore", "section": "🧹 Chores", "hidden": true },
+    { "type": "test", "section": "🧪 Tests", "hidden": true }
+  ],
+  "packages": {
+    ".": {}
+  }
+}
diff --git a/.github/release-please-manifest.json b/.github/release-please-manifest.json
new file mode 100644
index 0000000..d4f6f29
--- /dev/null
+++ b/.github/release-please-manifest.json
@@ -0,0 +1,3 @@
+{
+  ".": "3.0.0"
+}
diff --git a/.github/scripts/summarize-step.sh b/.github/scripts/summarize-step.sh
new file mode 100644
index 0000000..02d7731
--- /dev/null
+++ b/.github/scripts/summarize-step.sh
@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+# Run a CI command and stream its stdout+stderr to BOTH the workflow's
+# job log (live) and `$GITHUB_STEP_SUMMARY` (after the fact, with a
+# status-aware section heading). Preserves the command's exit code so
+# the calling step's `continue-on-error: true` records the real outcome
+# — letting a trailing gate step re-derive the job's pass/fail without
+# losing the per-step output.
+#
+# Section heading carries a leading status glyph (green-check on pass,
+# red-cross on fail) so you can scan the job summary and spot the
+# failing step at a glance. The <details> block defaults closed on
+# success (passing checks don't drown the summary) and open on failure
+# (failing output is visible without a click).
+#
+# Usage: bash .github/scripts/summarize-step.sh "Title" cmd arg1 arg2 ...
+
+set -o pipefail
+
+TITLE="$1"
+shift
+
+LOG="$(mktemp)"
+trap 'rm -f "$LOG"' EXIT
+
+"$@" 2>&1 | tee "$LOG"
+EC=${PIPESTATUS[0]}
+
+if [ "$EC" -eq 0 ]; then
+  STATUS="✅ Passed"
+  DETAILS_OPEN=""
+else
+  STATUS="❌ Failed (exit $EC)"
+  DETAILS_OPEN=" open"
+fi
+
+{
+  echo
+  echo "### $STATUS — $TITLE"
+  echo
+  echo "<details${DETAILS_OPEN}><summary>Output</summary>"
+  echo
+  echo '```text'
+  cat "$LOG"
+  echo '```'
+  echo
+  echo '</details>'
+} >> "$GITHUB_STEP_SUMMARY"
+
+exit "$EC"
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 326a412..a2a66a9 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -1,4 +1,4 @@
-name: CI/CD
+name: CI
 
 on:
   push:
@@ -6,12 +6,14 @@ on:
       - master
       - develop
     paths:
-      - .github/workflows/ci-cd.yml
+      - .github/workflows/ci.yml
+      - .github/scripts/**
       - "src/**"
       - "tests/**"
-      - .php_cs.dist
+      - .php-cs-fixer.dist.php
       - .phpcs.xml
-      - .scrutinizer.yml
+      - phpstan.dist.neon
+      - phpstan-baseline.neon
       - composer.json
       - phpunit.xml.dist
 
@@ -20,51 +22,102 @@ on:
   workflow_dispatch:
 
 jobs:
+  # Code style (PHP-CS-Fixer), static analysis (PHPStan) and PHP-version
+  # compatibility (PHP_CodeSniffer / PHPCompatibility) run once on a modern PHP.
+  # PHP-CS-Fixer, PHPStan and the shared iwf-web/php-coding-standard require PHP
+  # 7.4+, so they can't install on the 7.1-7.3 test legs — keeping them here avoids that.
+  style:
+    name: Code style & PHP compatibility
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: "8.5"
+          coverage: none
+
+      - name: Get Composer cache directory
+        id: composer-cache-dir-path
+        run: echo "dir=$(composer config cache-files-dir)" >> "$GITHUB_OUTPUT"
+      - name: Cache Composer downloads
+        uses: actions/cache@v6
+        with:
+          path: ${{ steps.composer-cache-dir-path.outputs.dir }}
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install dependencies
+        run: composer install --prefer-dist --no-progress
+
+      # Each check streams its output into the job summary and uses
+      # continue-on-error so one failure never skips the rest; a trailing gate
+      # re-derives the real pass/fail.
+      - name: Validate composer.json
+        id: validate
+        continue-on-error: true
+        run: bash .github/scripts/summarize-step.sh "composer validate" composer validate --strict
+
+      - name: PHP_CodeSniffer (PHP compatibility)
+        id: phpcs
+        continue-on-error: true
+        run: bash .github/scripts/summarize-step.sh "PHP_CodeSniffer" ./vendor/bin/phpcs
+
+      - name: PHP-CS-Fixer (code style)
+        id: cs-fixer
+        continue-on-error: true
+        run: bash .github/scripts/summarize-step.sh "PHP-CS-Fixer" ./vendor/bin/php-cs-fixer fix --diff --dry-run -v
+
+      - name: PHPStan (static analysis)
+        id: phpstan
+        continue-on-error: true
+        run: bash .github/scripts/summarize-step.sh "PHPStan" ./vendor/bin/phpstan analyse --no-progress
+
+      - name: Fail if any check failed
+        if: always()
+        run: |
+          if [ "${{ steps.validate.outcome }}" = "failure" ] \
+             || [ "${{ steps.phpcs.outcome }}" = "failure" ] \
+             || [ "${{ steps.cs-fixer.outcome }}" = "failure" ] \
+             || [ "${{ steps.phpstan.outcome }}" = "failure" ]; then
+            exit 1
+          fi
+
   test:
+    name: Test on PHP v${{ matrix.php }}
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        php: [7.1, 7.2, 7.3, 7.4]
+        php: [7.1, 7.2, 7.3, 7.4, 8.0, 8.1, 8.2, 8.3, 8.4, 8.5]
         include:
-          - php: 7.4
+          - php: 8.5
             test_with_coverage: 1
 
-    name: Test on PHP v${{ matrix.php }}
-
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v7
+        with:
+          # ocular (Scrutinizer coverage upload) reports HEAD's parent revision, so it
+          # needs the parent commit. The default depth-1 shallow checkout grafts HEAD to
+          # look parent-less; depth 2 (HEAD + parent) is the minimum that exposes it.
+          fetch-depth: 2
 
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
         if: matrix.test_with_coverage != 1
         with:
-          # Specify the PHP version you want to setup.
           php-version: "${{ matrix.php }}"
-          # Specify the extensions you want to add or remove. (eg. mbstring, :opcache)
-          # extensions: # optional
-          # Specify the values you want to add to php.ini. (post_max_size=256M, short_open_tag=On)
-          # ini-values: # optional
-          # Specify the code coverage driver you want to setup. (xdebug, pcov or none)
-          coverage: none # optional
-          # Specify the tools you want to setup. (eg. phpunit, phpcs)
-          # tools: # optional
+          coverage: none
 
       - name: Setup PHP with Xdebug
         uses: shivammathur/setup-php@v2
         if: matrix.test_with_coverage == 1
         with:
-          # Specify the PHP version you want to setup.
           php-version: "${{ matrix.php }}"
-          # Specify the extensions you want to add or remove. (eg. mbstring, :opcache)
-          # extensions: # optional
-          # Specify the values you want to add to php.ini. (post_max_size=256M, short_open_tag=On)
-          # ini-values: # optional
-          # Specify the code coverage driver you want to setup. (xdebug, pcov or none)
-          coverage: xdebug # optional
-          # Specify the tools you want to setup. (eg. phpunit, phpcs)
-          # tools: # optional
+          coverage: xdebug
 
       - name: Setup problem matchers for PHP
         run: echo "::add-matcher::${{ runner.tool_cache }}/php.json"
@@ -72,52 +125,65 @@ jobs:
       - name: Setup problem matchers for PHPUnit
         run: echo "::add-matcher::${{ runner.tool_cache }}/phpunit.json"
 
-      # https://github.com/actions/cache/blob/main/examples.md#php---composer
-      - name: Get Composer Cache Directory
+      - name: Get Composer cache directory
         id: composer-cache-dir-path
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
-      - name: Cache local composer repository
-        uses: actions/cache@v2
-        id: composer-cache
+        run: echo "dir=$(composer config cache-files-dir)" >> "$GITHUB_OUTPUT"
+      - name: Cache Composer downloads
+        uses: actions/cache@v6
         with:
-          # A list of files, directories, and wildcard patterns to cache and restore. See @actions/glob for supported patterns.
           path: ${{ steps.composer-cache-dir-path.outputs.dir }}
-          # An explicit key for restoring and saving the cache
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
-          # An ordered list of keys to use for restoring the cache if no cache hit occurred for key
-          restore-keys: |
-            ${{ runner.os }}-composer-
-
-      - name: Install dependencies
-        run: composer install --prefer-dist --no-progress --no-suggest
+          restore-keys: ${{ runner.os }}-composer-
 
-      - name: Check composer.json and composer.lock validity
-        run: composer validate --strict
+      # The style/compat tools require PHP 7.4+ and are exercised in the `style`
+      # job, so drop them here — otherwise dependency resolution fails on the
+      # 7.1-7.3 legs. Only PHPUnit is needed to run the tests.
+      - name: Drop dev-only style tools
+        run: composer remove --dev --no-update friendsofphp/php-cs-fixer iwf-web/php-coding-standard squizlabs/php_codesniffer phpcompatibility/php-compatibility dealerdirect/phpcodesniffer-composer-installer phpstan/phpstan phpstan/phpstan-phpunit phpstan/extension-installer
 
-      - name: Check with phpcs
-        run: ./vendor/bin/phpcs
-
-      # Don't make this a requirement for now, php-cs-fixer fails to follow PSR-12 standard
-      - name: Check whether code follows Symfony Code Syntax rules
-        continue-on-error: true
-        run: ./vendor/bin/php-cs-fixer fix --diff --dry-run -v
+      - name: Install dependencies
+        run: composer update --prefer-dist --no-progress
 
       - name: Run tests
-        run: ./vendor/bin/phpunit
-
+        id: phpunit
+        continue-on-error: true
+        # Coverage is driven here (not phpunit.xml.dist) so the config stays valid
+        # across PHPUnit 7-13. Only the coverage leg has a driver (Xdebug); the others
+        # pass --no-coverage so PHPUnit 12/13 don't complain about a missing driver.
+        run: |
+          if [ "${{ matrix.test_with_coverage }}" = "1" ]; then
+            flags="--coverage-clover coverage/logs/clover.xml --coverage-filter src"
+          else
+            flags="--no-coverage"
+          fi
+          bash .github/scripts/summarize-step.sh "PHPUnit" ./vendor/bin/phpunit $flags
+
+      # Coverage uploads are best-effort side effects (not pass/fail criteria),
+      # so they stay out of the gate and never break a build on a flaky upload.
       # https://github.com/php-coveralls/php-coveralls
       - name: Upload coverage report to Coveralls
-        if: github.event_name == 'push' && github.repository == 'D3strukt0r/votifier-client-php' && matrix.test_with_coverage == 1
+        if: github.event_name == 'push' && github.repository == 'Team-MaRo/votifier-client-php' && matrix.test_with_coverage == 1
+        continue-on-error: true
         env:
-          COVERALLS_REPO_TOKEN: ${{ secrets.COVERALLS_REPO_TOKEN }}
+          COVERALLS_REPO_TOKEN: ${{ github.token }}
         run: |
           curl -fsSL -o php-coveralls.phar https://github.com/php-coveralls/php-coveralls/releases/latest/download/php-coveralls.phar
           php php-coveralls.phar -v --coverage_clover=coverage/logs/clover.xml --json_path=coverage/logs/coveralls-upload.json
 
-      # https://scrutinizer-ci.com/docs/tools/external-code-coverage/
+      # Scrutinizer now serves ocular.phar behind a Cloudflare bot challenge that 403s
+      # non-browser clients (curl can't solve the JS challenge), so install ocular via
+      # Composer (sourced from GitHub/Packagist) instead of downloading the phar.
       # https://github.com/scrutinizer-ci/ocular
       - name: Upload coverage report to Scrutinizer
-        if: github.event_name == 'push' && github.repository == 'D3strukt0r/votifier-client-php' && matrix.test_with_coverage == 1
+        if: github.event_name == 'push' && github.repository == 'Team-MaRo/votifier-client-php' && matrix.test_with_coverage == 1
+        continue-on-error: true
+        run: |
+          composer global require scrutinizer/ocular
+          "$(composer global config home)/vendor/bin/ocular" code-coverage:upload --format=php-clover coverage/logs/clover.xml
+
+      - name: Fail if tests failed
+        if: always()
         run: |
-          curl -fsSL -o ocular.phar https://scrutinizer-ci.com/ocular.phar
-          php ocular.phar code-coverage:upload -v --format=php-clover coverage/logs/clover.xml
+          if [ "${{ steps.phpunit.outcome }}" = "failure" ]; then
+            exit 1
+          fi
diff --git a/.github/workflows/dependabot-automerge.yml b/.github/workflows/dependabot-automerge.yml
new file mode 100644
index 0000000..def9c31
--- /dev/null
+++ b/.github/workflows/dependabot-automerge.yml
@@ -0,0 +1,51 @@
+name: Dependabot Auto-Merge
+
+on:
+  pull_request:
+
+permissions:
+  pull-requests: write
+  contents: write
+
+jobs:
+  auto-merge:
+    name: Auto-Merge Dependabot PRs
+    runs-on: ubuntu-latest
+
+    # Checking the actor will prevent your Action run failing on non-Dependabot PRs
+    if: github.event.pull_request.user.login == 'dependabot[bot]' && github.repository == 'Team-MaRo/votifier-client-php'
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+
+      - name: Fetch Dependabot metadata 🔍
+        uses: dependabot/fetch-metadata@v3
+        id: metadata
+        with:
+          github-token: ${{ github.token }}
+
+      - name: Approve Dependabot PR if not already approved ✅
+        if: steps.metadata.outputs.update-type == 'version-update:semver-minor' || steps.metadata.outputs.update-type == 'version-update:semver-patch'
+        env:
+          PR_URL: ${{ github.event.pull_request.html_url }}
+          # PAT (a @Team-MaRo/CI member), not GITHUB_TOKEN, so the approval counts
+          # toward the CODEOWNERS requirement on Dependabot-managed paths.
+          GITHUB_TOKEN: ${{ secrets.GH_PAT }}
+        run: |
+          gh pr checkout "$PR_URL" # sets the upstream metadata for `gh pr status`
+          if [ "$(gh pr status --json reviewDecision -q .currentBranch.reviewDecision)" != "APPROVED" ]; then
+            gh pr review --approve "$PR_URL"
+          else
+            echo "PR already approved, skipping additional approvals to minimize emails/notification noise."
+          fi
+
+      - name: Enable auto-merge for Dependabot PR 🪄
+        if: steps.metadata.outputs.update-type == 'version-update:semver-minor' || steps.metadata.outputs.update-type == 'version-update:semver-patch'
+        env:
+          PR_URL: ${{ github.event.pull_request.html_url }}
+          # PAT (not GITHUB_TOKEN) so the resulting merge commit fires
+          # downstream workflows — `bump-pnpm-hash.yml` watches `pnpm-lock.yaml`
+          # paths and would otherwise stay asleep for Dependabot lockfile PRs.
+          GITHUB_TOKEN: ${{ secrets.GH_PAT }}
+        run: gh pr merge --auto --merge "$PR_URL"
diff --git a/.github/workflows/dependabot-validate.yml b/.github/workflows/dependabot-validate.yml
new file mode 100644
index 0000000..d49ebec
--- /dev/null
+++ b/.github/workflows/dependabot-validate.yml
@@ -0,0 +1,35 @@
+name: Dependabot Validate Config
+
+on:
+  push:
+    branches: [master, develop]
+    paths:
+      - '.github/dependabot.yml'
+      - '.github/workflows/dependabot-validate.yml'
+  pull_request:
+    paths:
+      - '.github/dependabot.yml'
+      - '.github/workflows/dependabot-validate.yml'
+
+permissions:
+  pull-requests: write
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+
+      - name: Validate dependabot config
+        uses: marocchino/validate-dependabot@v3
+        id: validate
+
+      - name: Comment validation results
+        uses: marocchino/sticky-pull-request-comment@v3
+        # Always run but only if a PR
+        if: ${{ !cancelled() && github.event_name == 'pull_request' }}
+        with:
+          header: validate-dependabot
+          message: ${{ steps.validate.outputs.markdown }}
diff --git a/.github/workflows/greetings.yml b/.github/workflows/greetings.yml
index 1393244..666b188 100644
--- a/.github/workflows/greetings.yml
+++ b/.github/workflows/greetings.yml
@@ -1,16 +1,26 @@
 name: Greetings
 
-on: [pull_request, issues]
+on:
+  pull_request:
+    types:
+      - opened
+  issues:
+    types:
+      - opened
+
+permissions:
+  issues: write
+  pull-requests: write
 
 jobs:
   greeting:
+    name: Greet First-Time Contributors
     runs-on: ubuntu-latest
+    if: github.actor != 'dependabot[bot]'
 
     steps:
-      - uses: actions/first-interaction@v1
+      - name: Greet First-Time Contributors
+        uses: actions/first-interaction@v3
         with:
-          repo-token: ${{ secrets.GITHUB_TOKEN }}
-          # Comment to post on an individuals first issue
-          issue-message: "Thank you for taking the courage of creating an issue here for the first time. We can't see everything, so this project heavily depends on people like you." # optional
-          # Comment to post on an individuals first pull request
-          pr-message: "Thank you for taking your precious time to create a pull request on this repository for the first time. Your work might actually benefit many others." # optional
+          issue_message: "Thank you for taking the courage of creating an issue here for the first time. We can't see everything, so this project heavily depends on people like you."
+          pr_message: "Thank you for taking your precious time to create a pull request on this repository for the first time. Your work might actually benefit many others."
diff --git a/.github/workflows/label.yml b/.github/workflows/label.yml
index 193c219..af0ebd0 100644
--- a/.github/workflows/label.yml
+++ b/.github/workflows/label.yml
@@ -2,15 +2,17 @@ name: Labeler
 
 on: [pull_request]
 
+permissions:
+  contents: read
+  pull-requests: write # Adding Existing Labels
+  issues: write # Creating New Labels
+
 jobs:
   label:
+    name: Label PR
     runs-on: ubuntu-latest
-
     steps:
-      - uses: actions/labeler@v2
+      - name: Label PR
+        uses: actions/labeler@v6
         with:
-          repo-token: ${{ secrets.GITHUB_TOKEN }}
-          # The path to the label configuration file
-          # configuration-path: .github/labeler.yml # optional, default is ".github/labeler.yml"
-          # Whether or not to remove labels when matching files are reverted or no longer changed by the PR
-          sync-labels: true # optional, default is "false"
+          sync-labels: true
diff --git a/.github/workflows/stale.yml b/.github/workflows/stale.yml
index c7399f3..f257a8e 100644
--- a/.github/workflows/stale.yml
+++ b/.github/workflows/stale.yml
@@ -4,49 +4,26 @@ on:
   schedule:
     - cron: "0 0 * * *"
 
+permissions:
+  actions: write
+  issues: write
+  pull-requests: write
+
 jobs:
   stale:
+    name: Mark stale issues and PRs
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/stale@v1
+      - name: Mark stale issues and PRs
+        uses: actions/stale@v10
         with:
-          repo-token: ${{ secrets.GITHUB_TOKEN }}
-          # The message to post on the issue when tagging it. If none provided, will not mark issues stale.
-          stale-issue-message: "Stale issue" # optional
-          # The message to post on the pr when tagging it. If none provided, will not mark pull requests stale.
-          stale-pr-message: "Stale pull request" # optional
-          # The message to post on the issue when closing it. If none provided, will not comment when closing an issue.
-          close-issue-message: "Stale issue closed" # optional
-          # The message to post on the pr when closing it. If none provided, will not comment when closing a pull requests.
-          close-pr-message: "Stale pull request closed" # optional
-          # The number of days old an issue can be before marking it stale. Set to -1 to never mark issues or pull requests as stale automatically.
-          # days-before-stale: 60 # optional, default is "60"
-          # The number of days to wait to close an issue or pull request after it being marked stale. Set to -1 to never close stale issues.
-          # days-before-close: 7 # optional, default is "7"
-          # The label to apply when an issue is stale.
-          stale-issue-label: "no-issue-activity" # optional, default is "Stale"
-          # The label to apply when an issue is closed.
-          # close-issue-label: # optional
-          # The labels to apply when an issue is exempt from being marked stale. Separate multiple labels with commas (eg. "label1,label2")
-          exempt-issue-labels: "awaiting-approval,work-in-progress" # optional
-          # The label to apply when a pull request is stale.
-          stale-pr-label: "no-pr-activity" # optional, default is "Stale"
-          # The label to apply when a pull request is closed.
-          # close-pr-label: # optional
-          # The labels to apply when a pull request is exempt from being marked stale. Separate multiple labels with commas (eg. "label1,label2")
-          exempt-pr-labels: "awaiting-approval,work-in-progress" # optional
-          # Only issues or pull requests with all of these labels are checked if stale. Defaults to `[]` (disabled) and can be a comma-separated list of labels.
-          only-labels: "awaiting-feedback,awaiting-answers" # optional
-          # The maximum number of operations per run, used to control rate limiting.
-          # operations-per-run: 30 # optional, default is "30"
-          # Remove stale labels from issues when they are updated or commented on.
-          # remove-stale-when-updated: true # optional, default is "true"
-          # Run the processor in debug mode without actually performing any operations on live issues.
-          # debug-only: # optional
-          # The order to get issues or pull requests. Defaults to false, which is descending
-          # ascending: false # optional, default is "false"
-          # Skip adding stale message when marking a pull request as stale.
-          # skip-stale-pr-message: # optional
-          # Skip adding stale message when marking an issue as stale.
-          # skip-stale-issue-message: # optional
+          stale-issue-message: "Stale issue"
+          stale-pr-message: "Stale pull request"
+          close-issue-message: "Stale issue closed"
+          close-pr-message: "Stale pull request closed"
+          stale-issue-label: "no-issue-activity"
+          exempt-issue-labels: "awaiting-approval,work-in-progress"
+          stale-pr-label: "no-pr-activity"
+          exempt-pr-labels: "awaiting-approval,work-in-progress"
+          only-labels: "awaiting-feedback,awaiting-answers"
diff --git a/.php-cs-fixer.dist.php b/.php-cs-fixer.dist.php
index 3fef336..16ef362 100644
--- a/.php-cs-fixer.dist.php
+++ b/.php-cs-fixer.dist.php
@@ -1,57 +1,63 @@
-<?php
+<?php declare(strict_types=1);
 
-$year = \date('Y');
-$header = <<<EOF
-Votifier PHP Client
+/**
+ * Votifier PHP Client
+ *
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
+ */
 
-@package   VotifierClient
-@author    Manuele Vaccari <manuele.vaccari@gmail.com>
-@copyright Copyright (c) 2017-$year Manuele Vaccari <manuele.vaccari@gmail.com>
-@license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
-@link      https://github.com/D3strukt0r/votifier-client-php
-EOF;
+require_once __DIR__.'/vendor/autoload.php';
 
-$finder = PhpCsFixer\Finder::create()
-    ->in(__DIR__)
-;
+use IWFWeb\CodingStandard\IWFWebStandardRiskySet;
+use IWFWeb\CodingStandard\IWFWebStandardSet;
+use PhpCsFixer\Config;
+use PhpCsFixer\Finder;
 
-return PhpCsFixer\Config::create()
-    ->setRiskyAllowed(true)
-    ->setRules(
-        [
-            '@PSR1' => true,
-            '@PSR2' => true,
-            '@PhpCsFixer' => true,
-            '@PhpCsFixer:risky' => true,
-            '@Symfony' => true,
-            '@Symfony:risky' => true,
-            'header_comment' => [
-                'comment_type' => 'PHPDoc',
-                'header' => $header,
-            ],
-            'concat_space' => [
-                'spacing' => 'one',
-            ],
-            'ordered_imports' => [
-                'imports_order' => [
-                    'class',
-                    'const',
-                    'function',
-                ],
-            ],
-            'no_extra_blank_lines' => [
-                'tokens' => ['default'],
-            ],
-            'php_unit_test_case_static_method_calls' => [
-                'call_type' => 'this',
-            ],
-            'linebreak_after_opening_tag' => true,
-            'mb_str_functions' => true,
-            'no_php4_constructor' => true,
-            'native_function_invocation' => false,
-            'no_superfluous_elseif' => false,
-        ]
+preg_match(
+    '/Copyright \(c\) ([0-9][0-9,\s-]*[0-9])\s+(.+)/',
+    (string) file_get_contents(__DIR__.'/LICENSE.txt'),
+    $copyright,
+);
+[, $years, $name] = $copyright;
+$email = json_decode((string) file_get_contents(__DIR__.'/composer.json'), true)['authors'][0]['email'];
+
+$header = <<<EOF
+    Votifier PHP Client
+
+    @package   Votifier Client
+    @author    {$name} <{$email}>
+    @copyright Copyright (c) {$years} {$name} <{$email}>
+    @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+    @link      https://github.com/Team-MaRo/votifier-client-php
+    EOF;
+
+// https://github.com/FriendsOfPHP/PHP-CS-Fixer/blob/master/doc/ruleSets/index.rst
+// https://github.com/FriendsOfPHP/PHP-CS-Fixer/blob/master/doc/rules/index.rst
+return (new Config())
+    ->registerCustomRuleSets([
+        new IWFWebStandardSet(),
+        new IWFWebStandardRiskySet(),
+    ])
+    ->setFinder(Finder::create()
+        ->in(__DIR__)
+        ->ignoreDotFiles(false)
+        ->ignoreVCSIgnored(true),
     )
-    ->setFinder($finder)
-    ->setCacheFile(__DIR__ . '/.php_coding_standard_cache.json')
+    ->setRiskyAllowed(true)
+    ->setRules([
+        '@IWFWeb/standard' => true,
+        '@IWFWeb/standard:risky' => true,
+        'header_comment' => [
+            'comment_type' => 'PHPDoc',
+            'header' => $header,
+        ],
+        // The library targets PHP 7.1, so only arrays may carry a trailing comma
+        // in multiline (valid since PHP 5). Trailing commas in function calls
+        // (PHP 7.3+) and declarations (PHP 8.0+) would break parsing on 7.1.
+        'trailing_comma_in_multiline' => ['elements' => ['arrays']],
+    ])
 ;
diff --git a/.phpcs.xml b/.phpcs.xml
index cada7ca..9cceaba 100644
--- a/.phpcs.xml
+++ b/.phpcs.xml
@@ -13,7 +13,12 @@
     <arg name="colors" />
     <arg name="extensions" value="php" />
 
-    <rule ref="PSR12" />
+    <!--
+        PHP-CS-Fixer (.php-cs-fixer.dist.php, the iwf-web/php-coding-standard set) owns
+        code style. PHP_CodeSniffer is used only as the PHP-version-compatibility gate
+        (PHPCompatibility, testVersion 7.1-); also enforcing PSR12 here just fought
+        PHP-CS-Fixer's choices (concat spacing, single-line empty bodies, ...).
+    -->
     <rule ref="PHPCompatibility" />
     <config name="testVersion" value="7.1-" />
 </ruleset>
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..e8ddfc2
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,126 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [3.0.0](https://github.com/Team-MaRo/votifier-client-php/compare/2.1.2...3.0.0) (2020-10-26)
+
+
+### ⚠ BREAKING CHANGES
+
+* **Namespace** changed from `D3strukt0r\VotifierClient` to `D3strukt0r\Votifier\Client`. Update every `use` statement.
+* **Classes were moved and renamed:**
+  * `ServerType\ClassicVotifier` → `Server\Votifier`
+  * `ServerType\NuVotifier` → `Server\NuVotifier`
+  * `ServerType\ServerTypeInterface` → `Server\ServerInterface`
+  * `VoteType\ClassicVote` → `Vote\ClassicVote`
+  * `VoteType\VoteInterface` → `Vote\VoteInterface`
+  * `ServerConnection` → `Socket` (internal), and the `Messages` class was removed.
+* **Construction is now a fluent builder** (no more positional constructors), and you send on the server object directly — the `Vote` wrapper class is gone. `sendVote()` is variadic, so several votes can be sent at once:
+
+  ```php
+  // before (2.x)
+  $serverType = new ClassicVotifier('127.0.0.1', null, $publicKey);
+  $voteType = new ClassicVote($username, 'Your vote list', $ip);
+  (new Vote($voteType, $serverType))->send();
+
+  // after (3.0.0)
+  use D3strukt0r\Votifier\Client\Server\Votifier;
+  use D3strukt0r\Votifier\Client\Vote\ClassicVote;
+
+  $server = (new Votifier())->setHost('127.0.0.1')->setPublicKey($publicKey); // ->setPort() optional, defaults to 8192
+  $vote = (new ClassicVote())->setUsername($username)->setServiceName('Your vote list')->setAddress($ip);
+  $server->sendVote($vote);
+  ```
+
+  For NuVotifier v2: `(new NuVotifier())->setHost('127.0.0.1')->setProtocolV2(true)->setToken('...')`.
+* **Failures now throw dedicated typed exceptions** instead of a generic `\Exception`. Catch what you need: `Exception\NotVotifierException`; the NuVotifier family `Exception\NuVotifierChallengeInvalidException`, `Exception\NuVotifierSignatureInvalidException`, `Exception\NuVotifierUnknownServiceException`, `Exception\NuVotifierUsernameTooLongException`; and the transport-level `Exception\Socket\NoConnectionException`, `Exception\Socket\PackageNotSentException`, `Exception\Socket\PackageNotReceivedException`. A missing required field throws `\InvalidArgumentException`.
+* `verifyConnection()` is available on a server to check reachability before sending.
+
+
+### ♻️ Refactoring
+
+* redesign Vote/Server API and rename to D3strukt0r\Votifier\Client ([2978a21](https://github.com/Team-MaRo/votifier-client-php/commit/2978a21fc70a6315d7990b30622125e6c283b639))
+* reorganize Server, Vote and Exception class layout ([224a1e8](https://github.com/Team-MaRo/votifier-client-php/commit/224a1e82ac879b269fb9be8980ba43c983ffa23f))
+* adopt PSR-12 and add dedicated exception classes ([9743475](https://github.com/Team-MaRo/votifier-client-php/commit/9743475ad7793f14a3ee21a5858be0921a46e642))
+
+## [2.1.2](https://github.com/Team-MaRo/votifier-client-php/compare/2.1.1...2.1.2) (2020-08-31)
+
+
+### 🧹 Chores
+
+* migrate CI from Travis CI to GitHub Actions and fix coverage reporting ([67165e1](https://github.com/Team-MaRo/votifier-client-php/commit/67165e178c32172395bd364ad13d5ac00e566c1e))
+
+## [2.1.1](https://github.com/Team-MaRo/votifier-client-php/compare/2.1.0...2.1.1) (2020-04-25)
+
+
+### 🐛 Bug Fixes
+
+* use correct NuVotifier server-error message and default language to null ([dfdf118](https://github.com/Team-MaRo/votifier-client-php/commit/dfdf11857eba1cd24aeeb54bc33960b0d51683c0))
+
+
+### 📚 Documentation
+
+* migrate documentation from README to Sphinx ([c04368e](https://github.com/Team-MaRo/votifier-client-php/commit/c04368ed8a568445d283677e4b58c068ff3f94bc))
+
+## [2.1.0](https://github.com/Team-MaRo/votifier-client-php/compare/2.0.0...2.1.0) (2020-03-09)
+
+
+### 🐛 Bug Fixes
+
+* resolve socket connection bugs and add PHP_CodeSniffer ([df15ece](https://github.com/Team-MaRo/votifier-client-php/commit/df15ece006eaa2d10fefaa100a89a2cd4788c1bf))
+
+
+### ♻️ Refactoring
+
+* rename LICENSE.md to LICENSE.txt ([0a47e31](https://github.com/Team-MaRo/votifier-client-php/commit/0a47e31cf5919e97985dd26f0ba3e632894a2f13))
+* drop deprecated PHP versions and add type declarations ([a33754a](https://github.com/Team-MaRo/votifier-client-php/commit/a33754a0be1ef302d6c0ea91c0fc0b508bab05ef))
+
+## [2.0.0](https://github.com/Team-MaRo/votifier-client-php/compare/1.0.0...2.0.0) (2018-04-24)
+
+
+### ⚠ BREAKING CHANGES
+
+* **Namespace** changed from `Votifier\Client` to `D3strukt0r\VotifierClient` (with `ServerType\` and `VoteType\` sub-namespaces). Update every `use` statement.
+* **The single `Vote` class with a six-argument constructor was removed.** You now compose a server type, a vote type and a `Vote` wrapper, then call `send()`:
+
+  ```php
+  // before (1.x)
+  use Votifier\Client\Vote;
+  (new Vote('127.0.0.1', 8192, $publicKey, $username, 'My list', $ip))->send();
+
+  // after (2.0.0)
+  use D3strukt0r\VotifierClient\ServerType\ClassicVotifier;
+  use D3strukt0r\VotifierClient\VoteType\ClassicVote;
+  use D3strukt0r\VotifierClient\Vote;
+
+  $serverType = new ClassicVotifier('127.0.0.1', null, $publicKey); // null port defaults to 8192
+  $voteType = new ClassicVote($username, 'My list', $ip);
+  (new Vote($voteType, $serverType))->send();
+  ```
+
+* **NuVotifier is now supported** via `ServerType\NuVotifier($host, $port, $publicKey, $protocolV2 = false, $token = null)` — pass `true` and a token for the v2 protocol.
+* Sending still throws a generic `\Exception` on failure (typed exceptions arrive in 3.0.0).
+
+## [1.0.0](https://github.com/Team-MaRo/votifier-client-php/compare/0.0.1...1.0.0) (2018-04-22)
+
+
+### 🧹 Chores
+
+* refine the Composer configuration and project files ([923994f](https://github.com/Team-MaRo/votifier-client-php/commit/923994f2aadaf06316972d03400d2de62326a31b))
+* rename the license to LICENSE.md and stop tracking IDE project files ([90f3012](https://github.com/Team-MaRo/votifier-client-php/commit/90f3012b7caa7682fff54ca75688b90196c35f1e))
+
+## 0.0.1 (2016-03-13)
+
+
+### ✨ Features
+
+* add Votifier client and convert to a Composer package ([2c59024](https://github.com/Team-MaRo/votifier-client-php/commit/2c59024bae15a78063bed298053b47c6628e472f))
+
+
+### ♻️ Refactoring
+
+* restructure namespace and class layout ([8e28858](https://github.com/Team-MaRo/votifier-client-php/commit/8e28858c8a32dc56fd3ce0dad4fd20fcbde1adf3))
+* relocate client classes into the Votifier\Client namespace ([2d728e4](https://github.com/Team-MaRo/votifier-client-php/commit/2d728e47faa449de37b5c11a4f4302acc40d44e9))
diff --git a/phpstan-baseline.neon b/phpstan-baseline.neon
new file mode 100644
index 0000000..a924955
--- /dev/null
+++ b/phpstan-baseline.neon
@@ -0,0 +1,121 @@
+parameters:
+	ignoreErrors:
+		-
+			message: '#^Property D3strukt0r\\Votifier\\Client\\Server\\GenericServer\:\:\$host \(string\) in isset\(\) is not nullable\.$#'
+			identifier: isset.property
+			count: 1
+			path: src/Server/Votifier.php
+
+		-
+			message: '#^Property D3strukt0r\\Votifier\\Client\\Server\\GenericServer\:\:\$port \(int\) in isset\(\) is not nullable\.$#'
+			identifier: isset.property
+			count: 1
+			path: src/Server/Votifier.php
+
+		-
+			message: '#^Property D3strukt0r\\Votifier\\Client\\Server\\GenericServer\:\:\$publicKey \(string\) in isset\(\) is not nullable\.$#'
+			identifier: isset.property
+			count: 2
+			path: src/Server/Votifier.php
+
+		-
+			message: '#^Property D3strukt0r\\Votifier\\Client\\Server\\GenericServerTypeTest\:\:\$object \(D3strukt0r\\Votifier\\Client\\Server\\GenericServer\) does not accept null\.$#'
+			identifier: assign.propertyType
+			count: 1
+			path: tests/Server/GenericServerTypeTest.php
+
+		-
+			message: '#^Strict comparison using \!\=\= between array\<int\<0, max\>\|string, D3strukt0r\\Votifier\\Client\\Vote\\VoteInterface\> and null will always evaluate to true\.$#'
+			identifier: notIdentical.alwaysTrue
+			count: 1
+			path: tests/Server/GenericServerTypeTest.php
+
+		-
+			message: '#^Method D3strukt0r\\Votifier\\Client\\Server\\NuVotifierTest\:\:checkRequiredVariablesForPackageProvider\(\) return type has no value type specified in iterable type iterable\.$#'
+			identifier: missingType.iterableValue
+			count: 1
+			path: tests/Server/NuVotifierTest.php
+
+		-
+			message: '#^Method D3strukt0r\\Votifier\\Client\\Server\\NuVotifierTest\:\:notVotifierExceptionProvider\(\) return type has no value type specified in iterable type iterable\.$#'
+			identifier: missingType.iterableValue
+			count: 1
+			path: tests/Server/NuVotifierTest.php
+
+		-
+			message: '#^Method D3strukt0r\\Votifier\\Client\\Server\\NuVotifierTest\:\:nuVotifierResponseAfterSendVoteProvider\(\) return type has no value type specified in iterable type iterable\.$#'
+			identifier: missingType.iterableValue
+			count: 1
+			path: tests/Server/NuVotifierTest.php
+
+		-
+			message: '#^Property D3strukt0r\\Votifier\\Client\\Server\\NuVotifierTest\:\:\$nuvotifier \(D3strukt0r\\Votifier\\Client\\Server\\NuVotifier\) does not accept null\.$#'
+			identifier: assign.propertyType
+			count: 1
+			path: tests/Server/NuVotifierTest.php
+
+		-
+			message: '#^Property D3strukt0r\\Votifier\\Client\\Server\\NuVotifierTest\:\:\$nuvotifierV2 \(D3strukt0r\\Votifier\\Client\\Server\\NuVotifier\) does not accept null\.$#'
+			identifier: assign.propertyType
+			count: 1
+			path: tests/Server/NuVotifierTest.php
+
+		-
+			message: '#^Property D3strukt0r\\Votifier\\Client\\Server\\NuVotifierTest\:\:\$socketStub \(D3strukt0r\\Votifier\\Client\\Socket&PHPUnit\\Framework\\MockObject\\Stub\) does not accept null\.$#'
+			identifier: assign.propertyType
+			count: 1
+			path: tests/Server/NuVotifierTest.php
+
+		-
+			message: '#^Result of method D3strukt0r\\Votifier\\Client\\Server\\NuVotifier\:\:sendVote\(\) \(void\) is used\.$#'
+			identifier: method.void
+			count: 2
+			path: tests/Server/NuVotifierTest.php
+
+		-
+			message: '#^Result of method D3strukt0r\\Votifier\\Client\\Server\\NuVotifier\:\:verifyConnection\(\) \(void\) is used\.$#'
+			identifier: method.void
+			count: 1
+			path: tests/Server/NuVotifierTest.php
+
+		-
+			message: '#^Method D3strukt0r\\Votifier\\Client\\Server\\VotifierTest\:\:checkRequiredVariablesForPackageProvider\(\) return type has no value type specified in iterable type iterable\.$#'
+			identifier: missingType.iterableValue
+			count: 1
+			path: tests/Server/VotifierTest.php
+
+		-
+			message: '#^Method D3strukt0r\\Votifier\\Client\\Server\\VotifierTest\:\:checkRequiredVariablesForSocketProvider\(\) return type has no value type specified in iterable type iterable\.$#'
+			identifier: missingType.iterableValue
+			count: 1
+			path: tests/Server/VotifierTest.php
+
+		-
+			message: '#^Property D3strukt0r\\Votifier\\Client\\Server\\VotifierTest\:\:\$socketStub \(D3strukt0r\\Votifier\\Client\\Socket&PHPUnit\\Framework\\MockObject\\Stub\) does not accept null\.$#'
+			identifier: assign.propertyType
+			count: 1
+			path: tests/Server/VotifierTest.php
+
+		-
+			message: '#^Property D3strukt0r\\Votifier\\Client\\Server\\VotifierTest\:\:\$votifier \(D3strukt0r\\Votifier\\Client\\Server\\Votifier\) does not accept null\.$#'
+			identifier: assign.propertyType
+			count: 1
+			path: tests/Server/VotifierTest.php
+
+		-
+			message: '#^Result of method D3strukt0r\\Votifier\\Client\\Server\\Votifier\:\:sendVote\(\) \(void\) is used\.$#'
+			identifier: method.void
+			count: 1
+			path: tests/Server/VotifierTest.php
+
+		-
+			message: '#^Result of method D3strukt0r\\Votifier\\Client\\Server\\Votifier\:\:verifyConnection\(\) \(void\) is used\.$#'
+			identifier: method.void
+			count: 1
+			path: tests/Server/VotifierTest.php
+
+		-
+			message: '#^Property D3strukt0r\\Votifier\\Client\\Vote\\ClassicVoteTest\:\:\$object \(D3strukt0r\\Votifier\\Client\\Vote\\ClassicVote\) does not accept null\.$#'
+			identifier: assign.propertyType
+			count: 1
+			path: tests/Vote/ClassicVoteTest.php
diff --git a/phpstan.dist.neon b/phpstan.dist.neon
new file mode 100644
index 0000000..0521881
--- /dev/null
+++ b/phpstan.dist.neon
@@ -0,0 +1,9 @@
+includes:
+    - phpstan-baseline.neon
+
+parameters:
+    level: 6
+    treatPhpDocTypesAsCertain: false
+    paths:
+        - src
+        - tests
diff --git a/phpunit.xml.dist b/phpunit.xml.dist
index a33b636..172c8ef 100644
--- a/phpunit.xml.dist
+++ b/phpunit.xml.dist
@@ -4,20 +4,14 @@
          xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.3/phpunit.xsd"
          bootstrap="./vendor/autoload.php"
          colors="true">
-    <coverage>
-        <include>
-            <directory suffix=".php">src</directory>
-        </include>
-        <report>
-            <clover outputFile="coverage/logs/clover.xml" />
-            <html outputDirectory="coverage/html" />
-            <text outputFile="php://stdout" />
-        </report>
-    </coverage>
+    <!--
+        Coverage is configured on the command line (see the CI workflow), not here:
+        the <coverage> element only exists in the PHPUnit 9.3+ schema, so PHPUnit 7/8
+        (the PHP 7.1/7.2 legs) reject it, and PHPUnit 13 ignores its <include> anyway.
+    -->
     <testsuites>
         <testsuite name="All">
             <directory suffix=".php">tests</directory>
         </testsuite>
     </testsuites>
-    <logging />
 </phpunit>

From b203e67f2afac8b25efd5c274e32d3022228ff6a Mon Sep 17 00:00:00 2001
From: D3strukt0r <dev@d3strukt0r.dev>
Date: Mon, 29 Jun 2026 22:45:00 +0200
Subject: [PATCH 10/13] chore: add an end-to-end test server

Add a standalone PHP app under public/ that drives the library against a real server, a compose.yml with spigot and web services, and a classic-Votifier feedback listener under tools/ for confirming that votes are received.
---
 Dockerfile                                    |  5 ++
 compose.yml                                   | 48 +++++++++++
 public/.dockerignore                          |  1 +
 public/Controller/AbstractController.php      | 80 +++++++++++++++++++
 public/Controller/FaviconController.php       | 27 +++++++
 public/Controller/FormController.php          | 27 +++++++
 public/Controller/NuVotifierController.php    | 77 ++++++++++++++++++
 public/Controller/VotifierController.php      | 56 +++++++++++++
 public/Dockerfile                             | 21 +++++
 public/Exception/NotFoundException.php        | 17 ++++
 public/Service/Container.php                  | 62 ++++++++++++++
 public/Service/ControllerResolver.php         | 30 +++++++
 public/Templating/RouterHelper.php            | 49 ++++++++++++
 public/composer.json                          | 30 +++++++
 public/index.php                              | 80 +++++++++++++++++++
 public/start.sh                               |  9 +++
 public/templates/base.php                     | 25 ++++++
 public/templates/form.php                     | 30 +++++++
 public/templates/layout.php                   | 11 +++
 .../VoteFeedbackListener.java                 | 32 ++++++++
 tools/votifier-listener/build.sh              | 20 +++++
 21 files changed, 737 insertions(+)
 create mode 100644 Dockerfile
 create mode 100644 compose.yml
 create mode 100644 public/.dockerignore
 create mode 100644 public/Controller/AbstractController.php
 create mode 100644 public/Controller/FaviconController.php
 create mode 100644 public/Controller/FormController.php
 create mode 100644 public/Controller/NuVotifierController.php
 create mode 100644 public/Controller/VotifierController.php
 create mode 100644 public/Dockerfile
 create mode 100644 public/Exception/NotFoundException.php
 create mode 100644 public/Service/Container.php
 create mode 100644 public/Service/ControllerResolver.php
 create mode 100644 public/Templating/RouterHelper.php
 create mode 100644 public/composer.json
 create mode 100644 public/index.php
 create mode 100755 public/start.sh
 create mode 100644 public/templates/base.php
 create mode 100644 public/templates/form.php
 create mode 100644 public/templates/layout.php
 create mode 100644 tools/votifier-listener/VoteFeedbackListener.java
 create mode 100755 tools/votifier-listener/build.sh

diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000..98f0f2b
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,5 @@
+FROM php:8.5-cli
+
+WORKDIR /usr/src/app
+
+RUN apt-get update && apt-get install -y
diff --git a/compose.yml b/compose.yml
new file mode 100644
index 0000000..ea64e23
--- /dev/null
+++ b/compose.yml
@@ -0,0 +1,48 @@
+services:
+  php:
+    build:
+      context: .
+    volumes:
+      - .:/usr/src/app
+
+  # Minecraft Spigot server to test the client against a real Votifier endpoint.
+  # Pin a version with SPIGOT_IMAGE (e.g. SPIGOT_IMAGE=d3strukt0r/spigot:26.1.2).
+  # Drop a Votifier/NuVotifier plugin jar into ./server/plugins, then send votes
+  # from the client to host "spigot", port 8192.
+  spigot:
+    image: ${SPIGOT_IMAGE:-d3strukt0r/spigot}
+    restart: unless-stopped
+    stdin_open: true   # console usable via `docker compose attach spigot`
+    tty: true
+    stop_grace_period: 60s
+    ports:
+      - 25565:25565  # Minecraft
+      - 8192:8192    # Votifier / NuVotifier
+    environment:
+      EULA: "true"
+      MEMORY: 2G
+    volumes:
+      - ./server:/srv/spigot  # gitignored; worlds, plugins, configs, keys persist here
+
+  # Web UI (public/) that drives the library against the spigot server above.
+  # `docker compose up web` builds it, installs its deps and serves it on
+  # http://localhost:8000. It reaches the plugin over the compose network
+  # (VOTIFIER_HOST=spigot), so no host port juggling is needed.
+  web:
+    build:
+      context: ./public
+      dockerfile: Dockerfile
+    command: bash start.sh
+    environment:
+      LISTEN: 0.0.0.0:8000   # bind all interfaces so the published port is reachable
+      VOTIFIER_HOST: spigot  # connect to the spigot service instead of 127.0.0.1
+    volumes:
+      - .:/app
+      - web-vendor:/app/public/vendor  # container-only deps, isolated from the host
+    ports:
+      - 8000:8000
+    depends_on:
+      - spigot
+
+volumes:
+  web-vendor:
diff --git a/public/.dockerignore b/public/.dockerignore
new file mode 100644
index 0000000..48b8bf9
--- /dev/null
+++ b/public/.dockerignore
@@ -0,0 +1 @@
+vendor/
diff --git a/public/Controller/AbstractController.php b/public/Controller/AbstractController.php
new file mode 100644
index 0000000..710ec34
--- /dev/null
+++ b/public/Controller/AbstractController.php
@@ -0,0 +1,80 @@
+<?php
+
+/**
+ * Votifier PHP Client
+ *
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
+ */
+
+namespace App\Controller;
+
+use Psr\Container\ContainerInterface;
+use Symfony\Component\HttpFoundation\Exception\SessionNotFoundException;
+use Symfony\Component\HttpFoundation\RedirectResponse;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
+
+abstract class AbstractController
+{
+    /**
+     * @var null|ContainerInterface
+     */
+    protected $container;
+
+    /**
+     * @required
+     */
+    public function setContainer(ContainerInterface $container): ?ContainerInterface
+    {
+        $previous = $this->container;
+        $this->container = $container;
+
+        return $previous;
+    }
+
+    protected function generateUrl(string $route, array $parameters = [], int $referenceType = UrlGeneratorInterface::ABSOLUTE_PATH): string
+    {
+        return $this->container->get('router')->generate($route, $parameters, $referenceType);
+    }
+
+    protected function redirect(string $url, int $status = 302): RedirectResponse
+    {
+        return new RedirectResponse($url, $status);
+    }
+
+    protected function redirectToRoute(string $route, array $parameters = [], int $status = 302): RedirectResponse
+    {
+        return $this->redirect($this->generateUrl($route, $parameters), $status);
+    }
+
+    protected function addFlash(string $type, $message): void
+    {
+        try {
+            $this->container->get('request_stack')->getSession()->getFlashBag()->add($type, $message);
+        } catch (SessionNotFoundException $e) {
+            throw new \LogicException('You cannot use the addFlash method if sessions are disabled. Enable them in "config/packages/framework.yaml".', 0, $e);
+        }
+    }
+
+    protected function renderView(string $view, array $parameters = []): string
+    {
+        return $this->container->get('templating')->render($view, $parameters);
+    }
+
+    protected function render(string $view, array $parameters = [], ?Response $response = null): Response
+    {
+        $content = $this->renderView($view, $parameters);
+
+        if ($response === null) {
+            $response = new Response();
+        }
+
+        $response->setContent($content);
+
+        return $response;
+    }
+}
diff --git a/public/Controller/FaviconController.php b/public/Controller/FaviconController.php
new file mode 100644
index 0000000..7e5769f
--- /dev/null
+++ b/public/Controller/FaviconController.php
@@ -0,0 +1,27 @@
+<?php
+
+/**
+ * Votifier PHP Client
+ *
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
+ */
+
+namespace App\Controller;
+
+use Symfony\Component\HttpFoundation\Response;
+
+/**
+ * Browsers auto-request /favicon.ico; without a route the kernel throws
+ * NotFoundHttpException and floods the log. Answer it with an empty 404.
+ */
+class FaviconController extends AbstractController
+{
+    public function __invoke(): Response
+    {
+        return new Response('', Response::HTTP_NOT_FOUND);
+    }
+}
diff --git a/public/Controller/FormController.php b/public/Controller/FormController.php
new file mode 100644
index 0000000..0b2ac27
--- /dev/null
+++ b/public/Controller/FormController.php
@@ -0,0 +1,27 @@
+<?php
+
+/**
+ * Votifier PHP Client
+ *
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
+ */
+
+namespace App\Controller;
+
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+class FormController extends AbstractController
+{
+    public function __invoke(Request $request): Response
+    {
+        return $this->render('form.php', [
+            'success' => $request->get('success'),
+            'error' => $request->get('error'),
+        ]);
+    }
+}
diff --git a/public/Controller/NuVotifierController.php b/public/Controller/NuVotifierController.php
new file mode 100644
index 0000000..34d317e
--- /dev/null
+++ b/public/Controller/NuVotifierController.php
@@ -0,0 +1,77 @@
+<?php
+
+/**
+ * Votifier PHP Client
+ *
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
+ */
+
+namespace App\Controller;
+
+use D3strukt0r\Votifier\Client\Exception\NotVotifierException;
+use D3strukt0r\Votifier\Client\Exception\NuVotifierChallengeInvalidException;
+use D3strukt0r\Votifier\Client\Exception\NuVotifierException;
+use D3strukt0r\Votifier\Client\Exception\NuVotifierSignatureInvalidException;
+use D3strukt0r\Votifier\Client\Exception\NuVotifierUnknownServiceException;
+use D3strukt0r\Votifier\Client\Exception\NuVotifierUsernameTooLongException;
+use D3strukt0r\Votifier\Client\Exception\Socket\NoConnectionException;
+use D3strukt0r\Votifier\Client\Exception\Socket\PackageNotReceivedException;
+use D3strukt0r\Votifier\Client\Exception\Socket\PackageNotSentException;
+use D3strukt0r\Votifier\Client\Server\NuVotifier;
+use D3strukt0r\Votifier\Client\Vote\ClassicVote;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\Yaml\Yaml;
+
+class NuVotifierController extends AbstractController
+{
+    public function __invoke(Request $request): Response
+    {
+        $configFile = __DIR__.'/../../server/plugins/Votifier/config.yml';
+        if (!is_file($configFile)) {
+            return $this->redirectToRoute('index', ['error' => 'NuVotifier config not found at server/plugins/Votifier/config.yml — start the server with the NuVotifier plugin first.']);
+        }
+        $votifierConfig = Yaml::parseFile($configFile);
+
+        $server = (new NuVotifier())
+            ->setHost(getenv('VOTIFIER_HOST') ?: '127.0.0.1')
+            ->setProtocolV2(true)
+            ->setToken($votifierConfig['tokens']['default'])
+        ;
+        $vote = (new ClassicVote())
+            ->setUsername($request->get('username'))
+            ->setServiceName('Your vote list')
+            ->setAddress($_SERVER['REMOTE_ADDR'])
+        ;
+
+        try {
+            $server->sendVote($vote);
+
+            return $this->redirectToRoute('index', ['success' => 'Connection created, and vote sent. Doesn\'t mean the server handled it correctly, but the client did.']);
+        } catch (\InvalidArgumentException $e) {
+            return $this->redirectToRoute('index', ['error' => "Not all variables that are needed have been set. See {$e->getMessage()} for all errors."]);
+        } catch (NoConnectionException $e) {
+            return $this->redirectToRoute('index', ['error' => "Could not create a connection (socket) to the specified server: {$e->getMessage()}"]);
+        } catch (PackageNotReceivedException $e) {
+            return $this->redirectToRoute('index', ['error' => "Could not receive a response from the server: {$e->getMessage()}"]);
+        } catch (PackageNotSentException $e) {
+            return $this->redirectToRoute('index', ['error' => "If the package couldn't be send, for whatever reason."]);
+        } catch (NotVotifierException $e) {
+            return $this->redirectToRoute('index', ['error' => "The server didn't give a standard Votifier response"]);
+        } catch (NuVotifierChallengeInvalidException $e) {
+            return $this->redirectToRoute('index', ['error' => "Specific for NuVotifier: The challenge was invalid (Shouldn't happen by default, but it's here in case)."]);
+        } catch (NuVotifierSignatureInvalidException $e) {
+            return $this->redirectToRoute('index', ['error' => "Specific for NuVotifier: The signature was invalid (Shouldn't happen by default, but it's here in case)."]);
+        } catch (NuVotifierUnknownServiceException $e) {
+            return $this->redirectToRoute('index', ['error' => "Specific for NuVotifier: A token can be specific for a list, so if the list isn't supposed to use the given token, this message appears."]);
+        } catch (NuVotifierUsernameTooLongException $e) {
+            return $this->redirectToRoute('index', ['error' => "Specific for NuVotifier: A username cannot be over 16 characters (Why? Don't ask me)"]);
+        } catch (NuVotifierException $e) {
+            return $this->redirectToRoute('index', ['error' => "In case there is a new error message that wasn't added to the library, this will take care of that."]);
+        }
+    }
+}
diff --git a/public/Controller/VotifierController.php b/public/Controller/VotifierController.php
new file mode 100644
index 0000000..371a4f7
--- /dev/null
+++ b/public/Controller/VotifierController.php
@@ -0,0 +1,56 @@
+<?php
+
+/**
+ * Votifier PHP Client
+ *
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
+ */
+
+namespace App\Controller;
+
+use D3strukt0r\Votifier\Client\Exception\Socket\NoConnectionException;
+use D3strukt0r\Votifier\Client\Exception\Socket\PackageNotReceivedException;
+use D3strukt0r\Votifier\Client\Exception\Socket\PackageNotSentException;
+use D3strukt0r\Votifier\Client\Server\Votifier;
+use D3strukt0r\Votifier\Client\Vote\ClassicVote;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+class VotifierController extends AbstractController
+{
+    public function __invoke(Request $request): Response
+    {
+        $publicKeyFile = __DIR__.'/../../server/plugins/Votifier/rsa/public.key';
+        if (!is_file($publicKeyFile)) {
+            return $this->redirectToRoute('index', ['error' => 'Votifier public key not found at server/plugins/Votifier/rsa/public.key — start the server with the Votifier plugin first.']);
+        }
+
+        $server = (new Votifier())
+            ->setHost(getenv('VOTIFIER_HOST') ?: '127.0.0.1')
+            ->setPublicKey(file_get_contents($publicKeyFile))
+        ;
+        $vote = (new ClassicVote())
+            ->setUsername($request->get('username'))
+            ->setServiceName('Your vote list')
+            ->setAddress($request->server->get('REMOTE_ADDR'))
+        ;
+
+        try {
+            $server->sendVote($vote);
+
+            return $this->redirectToRoute('index', ['success' => 'Connection created, and vote sent. Doesn\'t mean the server handled it correctly, but the client did.']);
+        } catch (\InvalidArgumentException $e) {
+            return $this->redirectToRoute('index', ['error' => "Not all variables that are needed have been set. See {$e->getMessage()} for all errors."]);
+        } catch (NoConnectionException $e) {
+            return $this->redirectToRoute('index', ['error' => "Could not create a connection (socket) to the specified server: {$e->getMessage()}"]);
+        } catch (PackageNotReceivedException $e) {
+            return $this->redirectToRoute('index', ['error' => "Could not receive a response from the server: {$e->getMessage()}"]);
+        } catch (PackageNotSentException $e) {
+            return $this->redirectToRoute('index', ['error' => "If the package couldn't be send, for whatever reason."]);
+        }
+    }
+}
diff --git a/public/Dockerfile b/public/Dockerfile
new file mode 100644
index 0000000..b83d1c3
--- /dev/null
+++ b/public/Dockerfile
@@ -0,0 +1,21 @@
+# Image for the standalone end-to-end test server (public/). It needs PHP 7.2.5+
+# (Symfony 5.4) with the mbstring extension the library requires; openssl ships
+# with the base image. The app code and its vendor dir are mounted at runtime,
+# so this image only provides the PHP runtime, the extensions and composer.
+FROM php:7.2-cli
+
+ENV COMPOSER_ALLOW_SUPERUSER=1
+
+# php:7.2-cli is based on Debian buster, which is EOL — its apt mirrors moved to
+# archive.debian.org, so repoint sources there (and skip the expired-release check).
+RUN sed -i -e 's|http://deb.debian.org/debian|http://archive.debian.org/debian|g' \
+           -e '/buster-updates/d' \
+           -e '/security.debian.org/d' /etc/apt/sources.list \
+    && apt-get -o Acquire::Check-Valid-Until=false update \
+    && apt-get install -y --no-install-recommends git unzip libonig-dev \
+    && docker-php-ext-install mbstring \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
+
+WORKDIR /app/public
diff --git a/public/Exception/NotFoundException.php b/public/Exception/NotFoundException.php
new file mode 100644
index 0000000..18dd8da
--- /dev/null
+++ b/public/Exception/NotFoundException.php
@@ -0,0 +1,17 @@
+<?php
+
+/**
+ * Votifier PHP Client
+ *
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
+ */
+
+namespace App\Exception;
+
+use Psr\Container\NotFoundExceptionInterface;
+
+class NotFoundException extends \InvalidArgumentException implements NotFoundExceptionInterface {}
diff --git a/public/Service/Container.php b/public/Service/Container.php
new file mode 100644
index 0000000..6747903
--- /dev/null
+++ b/public/Service/Container.php
@@ -0,0 +1,62 @@
+<?php
+
+/**
+ * Votifier PHP Client
+ *
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
+ */
+
+namespace App\Service;
+
+use App\Exception\NotFoundException;
+use Psr\Container\ContainerInterface;
+
+class Container implements ContainerInterface
+{
+    /**
+     * @var array
+     */
+    private $definitions = [];
+
+    /**
+     * @var array
+     */
+    private $resolvedEntries = [];
+
+    public function __construct(array $definitions)
+    {
+        $this->definitions = array_merge($definitions, [ContainerInterface::class => $this]);
+    }
+
+    /**
+     * @return mixed
+     */
+    public function get(string $id)
+    {
+        if (!$this->has($id)) {
+            throw new NotFoundException("No entry or class found for '{$id}'");
+        }
+
+        if (\array_key_exists($id, $this->resolvedEntries)) {
+            return $this->resolvedEntries[$id];
+        }
+
+        $value = $this->definitions[$id];
+        if ($value instanceof \Closure) {
+            $value = $value($this);
+        }
+
+        $this->resolvedEntries[$id] = $value;
+
+        return $value;
+    }
+
+    public function has(string $id): bool
+    {
+        return \array_key_exists($id, $this->definitions) || \array_key_exists($id, $this->resolvedEntries);
+    }
+}
diff --git a/public/Service/ControllerResolver.php b/public/Service/ControllerResolver.php
new file mode 100644
index 0000000..c77d3ef
--- /dev/null
+++ b/public/Service/ControllerResolver.php
@@ -0,0 +1,30 @@
+<?php
+
+/**
+ * Votifier PHP Client
+ *
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
+ */
+
+namespace App\Service;
+
+use App\Controller\AbstractController;
+use Symfony\Component\HttpKernel\Controller\ContainerControllerResolver;
+
+class ControllerResolver extends ContainerControllerResolver
+{
+    protected function instantiateController(string $class): object
+    {
+        $controller = parent::instantiateController($class);
+
+        if ($controller instanceof AbstractController) {
+            $controller->setContainer($this->container);
+        }
+
+        return $controller;
+    }
+}
diff --git a/public/Templating/RouterHelper.php b/public/Templating/RouterHelper.php
new file mode 100644
index 0000000..93ff3c3
--- /dev/null
+++ b/public/Templating/RouterHelper.php
@@ -0,0 +1,49 @@
+<?php
+
+/**
+ * Votifier PHP Client
+ *
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
+ */
+
+namespace App\Templating;
+
+use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
+use Symfony\Component\Templating\Helper\Helper;
+
+/**
+ * Minimal "router" helper for the PHP templating engine, so templates can call
+ * $view['router']->path('route_name'). The standalone Templating component has
+ * no router helper (that lives in the framework bundle), so we provide one.
+ */
+final class RouterHelper extends Helper
+{
+    /**
+     * @var UrlGeneratorInterface
+     */
+    private $generator;
+
+    public function __construct(UrlGeneratorInterface $generator)
+    {
+        $this->generator = $generator;
+    }
+
+    public function path(string $name, array $parameters = []): string
+    {
+        return $this->generator->generate($name, $parameters, UrlGeneratorInterface::ABSOLUTE_PATH);
+    }
+
+    public function url(string $name, array $parameters = []): string
+    {
+        return $this->generator->generate($name, $parameters, UrlGeneratorInterface::ABSOLUTE_URL);
+    }
+
+    public function getName(): string
+    {
+        return 'router';
+    }
+}
diff --git a/public/composer.json b/public/composer.json
new file mode 100644
index 0000000..b6ea2d6
--- /dev/null
+++ b/public/composer.json
@@ -0,0 +1,30 @@
+{
+    "name": "d3strukt0r/votifier-client-e2e",
+    "description": "End-to-end test server for the Votifier client. Not published; kept separate so its web-framework dependencies stay out of the library.",
+    "type": "project",
+    "license": "MIT",
+    "minimum-stability": "dev",
+    "prefer-stable": true,
+    "repositories": [
+        {
+            "type": "path",
+            "url": ".."
+        }
+    ],
+    "require": {
+        "php": ">=7.1",
+        "d3strukt0r/votifier-client": "@dev",
+        "psr/container": "^1.1 || ^2.0",
+        "symfony/event-dispatcher": "^5.4",
+        "symfony/http-foundation": "^5.4",
+        "symfony/http-kernel": "^5.4",
+        "symfony/routing": "^5.4",
+        "symfony/templating": "^5.4",
+        "symfony/yaml": "^5.4"
+    },
+    "autoload": {
+        "psr-4": {
+            "App\\": ""
+        }
+    }
+}
diff --git a/public/index.php b/public/index.php
new file mode 100644
index 0000000..d38130c
--- /dev/null
+++ b/public/index.php
@@ -0,0 +1,80 @@
+<?php
+
+/**
+ * Votifier PHP Client
+ *
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
+ */
+
+require __DIR__.'/vendor/autoload.php';
+
+use App\Controller\FaviconController;
+use App\Controller\FormController;
+use App\Controller\NuVotifierController;
+use App\Controller\VotifierController;
+use App\Service\Container;
+use App\Service\ControllerResolver;
+use App\Templating\RouterHelper;
+use Psr\Container\ContainerInterface;
+use Symfony\Component\EventDispatcher\EventDispatcher;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\RequestStack;
+use Symfony\Component\HttpKernel\Controller\ArgumentResolver;
+use Symfony\Component\HttpKernel\EventListener\RouterListener;
+use Symfony\Component\HttpKernel\HttpKernel;
+use Symfony\Component\Routing\Generator\UrlGenerator;
+use Symfony\Component\Routing\Matcher\UrlMatcher;
+use Symfony\Component\Routing\RequestContext;
+use Symfony\Component\Routing\Route;
+use Symfony\Component\Routing\RouteCollection;
+use Symfony\Component\Templating\Helper\SlotsHelper;
+use Symfony\Component\Templating\Loader\FilesystemLoader;
+use Symfony\Component\Templating\PhpEngine;
+use Symfony\Component\Templating\TemplateNameParser;
+
+$routes = new RouteCollection();
+$routes->add('index', new Route('/', ['_controller' => FormController::class]));
+$routes->add('votifier', new Route('/votifier', ['_controller' => VotifierController::class]));
+$routes->add('nuvotifier', new Route('/nuvotifier', ['_controller' => NuVotifierController::class]));
+$routes->add('favicon', new Route('/favicon.ico', ['_controller' => FaviconController::class]));
+
+$request = Request::createFromGlobals();
+
+$context = new RequestContext();
+
+// Routing can match routes with incoming requests
+$matcher = new UrlMatcher($routes, $context);
+
+$dispatcher = new EventDispatcher();
+$dispatcher->addSubscriber(new RouterListener($matcher, new RequestStack()));
+
+$templating = null;
+$requestStack = new RequestStack();
+$generator = new UrlGenerator($routes, $context);
+$controllerResolver = new ControllerResolver(new Container([
+    'router' => $generator,
+    'request_stack' => $requestStack,
+    'templating' => static function (ContainerInterface $container) use (&$templating, &$generator) {
+        if ($templating === null) {
+            $filesystemLoader = new FilesystemLoader(__DIR__.'/templates/%name%');
+
+            $templating = new PhpEngine(new TemplateNameParser(), $filesystemLoader);
+            $templating->set(new SlotsHelper());
+            $templating->set(new RouterHelper($generator));
+        }
+
+        return $templating;
+    },
+]));
+$argumentResolver = new ArgumentResolver();
+
+$kernel = new HttpKernel($dispatcher, $controllerResolver, $requestStack, $argumentResolver);
+
+$response = $kernel->handle($request);
+$response->send();
+
+$kernel->terminate($request, $response);
diff --git a/public/start.sh b/public/start.sh
new file mode 100755
index 0000000..c758dd4
--- /dev/null
+++ b/public/start.sh
@@ -0,0 +1,9 @@
+#!/bin/bash
+
+set -euo pipefail
+
+cd "$( dirname "$0" )"
+[ -f vendor/autoload.php ] || composer install
+# LISTEN defaults to localhost for a host run; compose sets it to 0.0.0.0:8000
+# so the container's published port is reachable.
+php -S "${LISTEN:-localhost:8000}" index.php
diff --git a/public/templates/base.php b/public/templates/base.php
new file mode 100644
index 0000000..bf5d488
--- /dev/null
+++ b/public/templates/base.php
@@ -0,0 +1,25 @@
+<?php
+// @php-cs-fixer-ignore phpdoc_to_comment
+use Symfony\Component\Templating\PhpEngine;
+
+/** @var PhpEngine $view */ ?>
+<!DOCTYPE html>
+<html lang="en">
+    <head>
+        <meta charset="UTF-8">
+        <meta name="viewport" content="width=device-width, initial-scale=1.0">
+        <script src="https://cdn.tailwindcss.com?plugins=forms"></script>
+        <style type="text/tailwindcss">
+            @layer utilities {
+                .btn {
+                    @apply inline-block px-6 py-2 border-2 border-blue-600 text-blue-600 font-medium text-xs leading-tight uppercase rounded hover:bg-black hover:bg-opacity-5 focus:outline-none focus:ring-0 transition duration-150 ease-in-out;
+                }
+            }
+        </style>
+
+        <title><?php $view['slots']->output('title', 'Vote'); ?></title>
+    </head>
+    <body>
+        <?php $view['slots']->output('_content'); ?>
+    </body>
+</html>
diff --git a/public/templates/form.php b/public/templates/form.php
new file mode 100644
index 0000000..422bf30
--- /dev/null
+++ b/public/templates/form.php
@@ -0,0 +1,30 @@
+<?php
+// @php-cs-fixer-ignore phpdoc_to_comment
+use Symfony\Component\Templating\PhpEngine;
+
+/** @var PhpEngine $view */ ?>
+<?php $view->extend('layout.php'); ?>
+
+<?php if (!empty($success)) { ?>
+    <div class="p-4 mb-4 text-sm text-green-700 bg-green-100 rounded-lg dark:bg-green-200 dark:text-green-800" role="alert">
+        <?php echo $view->escape($success); ?>
+    </div>
+<?php } ?>
+<?php if (!empty($error)) { ?>
+    <div class="p-4 mb-4 text-sm text-red-700 bg-red-100 rounded-lg dark:bg-red-200 dark:text-red-800" role="alert">
+        <?php echo $view->escape($error); ?>
+    </div>
+<?php } ?>
+
+<h2 class="text-3xl font-bold mt-16">Votifier</h2>
+<form action="<?php echo $view['router']->path('votifier'); ?>">
+    <label for="username_votifier">Username:</label><br>
+    <input type="text" name="username" id="username_votifier" class="form-input">
+    <button type="submit" class="btn">Send</button>
+</form>
+<h2 class="text-3xl font-bold mt-16">NuVotifier</h2>
+<form action="<?php echo $view['router']->path('nuvotifier'); ?>">
+    <label for="username_nuvotifier">Username:</label><br>
+    <input type="text" name="username" id="username_nuvotifier" class="form-input">
+    <button type="submit" class="btn">Send</button>
+</form>
diff --git a/public/templates/layout.php b/public/templates/layout.php
new file mode 100644
index 0000000..82d67b2
--- /dev/null
+++ b/public/templates/layout.php
@@ -0,0 +1,11 @@
+<?php
+// @php-cs-fixer-ignore phpdoc_to_comment
+use Symfony\Component\Templating\PhpEngine;
+
+/** @var PhpEngine $view */ ?>
+<?php $view->extend('base.php'); ?>
+
+<div class="container mx-auto px-4 py-8">
+    <h1 class="text-4xl font-bold">Votifier GUI Tester</h1>
+    <?php $view['slots']->output('_content'); ?>
+</div>
diff --git a/tools/votifier-listener/VoteFeedbackListener.java b/tools/votifier-listener/VoteFeedbackListener.java
new file mode 100644
index 0000000..46dd381
--- /dev/null
+++ b/tools/votifier-listener/VoteFeedbackListener.java
@@ -0,0 +1,32 @@
+import com.vexsoftware.votifier.model.Vote;
+import com.vexsoftware.votifier.model.VoteListener;
+
+/**
+ * Classic Votifier vote listener for end-to-end testing.
+ *
+ * Votifier only calls this AFTER it has successfully decrypted a vote, so seeing
+ * the message is proof the server accepted the packet (not just that the client
+ * sent one). It broadcasts the vote to in-game chat, which also echoes to the
+ * server console (visible via `docker compose logs -f spigot`); if Bukkit isn't
+ * available it falls back to printing to the console.
+ *
+ * Build with the Votifier jar on the classpath and drop the resulting .class into
+ * plugins/Votifier/listeners/ (see tools/votifier-listener/build.sh).
+ */
+public class VoteFeedbackListener implements VoteListener {
+
+    public void voteMade(Vote vote) {
+        String message = "[VoteFeedback] vote received -> " + vote;
+
+        // Broadcast to in-game chat. Bukkit.broadcastMessage() also echoes to the
+        // server console, so this is the single output. Done reflectively so the
+        // listener compiles against only the Votifier jar. If Bukkit isn't available,
+        // fall back to a plain console line (avoids printing the message twice).
+        try {
+            Class<?> bukkit = Class.forName("org.bukkit.Bukkit");
+            bukkit.getMethod("broadcastMessage", String.class).invoke(null, message);
+        } catch (Throwable noBukkit) {
+            System.out.println(message);
+        }
+    }
+}
diff --git a/tools/votifier-listener/build.sh b/tools/votifier-listener/build.sh
new file mode 100755
index 0000000..04ca9ab
--- /dev/null
+++ b/tools/votifier-listener/build.sh
@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+# Compile VoteFeedbackListener against the Votifier jar and install the .class
+# into the server's listeners folder. Uses a Java 8 JDK in Docker (classic
+# Votifier targets Java 8), so no local JDK is needed.
+set -euo pipefail
+cd "$(dirname "$0")/../.."  # repo root
+
+JAR=$(ls server/plugins/[Vv]otifier*.jar 2>/dev/null | head -1 || true)
+if [ -z "$JAR" ]; then
+  echo "No Votifier jar found in server/plugins/ — start the server with the plugin first." >&2
+  exit 1
+fi
+
+mkdir -p server/plugins/Votifier/listeners
+docker run --rm -v "$PWD":/work -w /work eclipse-temurin:8-jdk \
+  javac -cp "$JAR" -d server/plugins/Votifier/listeners \
+  tools/votifier-listener/VoteFeedbackListener.java
+
+echo "Installed VoteFeedbackListener.class -> server/plugins/Votifier/listeners/"
+echo "Restart the server (docker compose restart spigot) to load it."

From a7b7ac0b8ee50e9292deb31184f10b67857e1c49 Mon Sep 17 00:00:00 2001
From: D3strukt0r <dev@d3strukt0r.dev>
Date: Mon, 29 Jun 2026 22:50:00 +0200
Subject: [PATCH 11/13] build: support Composer 2 and PHP 8

---
 composer.json | 68 ++++++++++++++++++---------------------------------
 1 file changed, 24 insertions(+), 44 deletions(-)

diff --git a/composer.json b/composer.json
index 40e22ce..f846d62 100644
--- a/composer.json
+++ b/composer.json
@@ -7,33 +7,24 @@
         "vote",
         "votifier"
     ],
-    "homepage": "https://github.com/D3strukt0r/votifier-client-php",
-    "license": "GPL-3.0-or-later",
+    "homepage": "https://github.com/Team-MaRo/votifier-client-php",
+    "license": "MIT",
     "authors": [
         {
             "name": "Manuele Vaccari",
-            "email": "manuele.vaccari@gmail.com",
+            "email": "dev@d3strukt0r.dev",
             "homepage": "https://github.com/D3strukt0r",
-            "role": "Developer"
+            "role": "Maintainer"
         }
     ],
     "support": {
-        "email": "manuele.vaccari@gmail.com",
-        "issues": "https://github.com/D3strukt0r/votifier-client-php/issues",
-        "wiki": "https://github.com/D3strukt0r/votifier-client-php/wiki",
-        "source": "https://github.com/D3strukt0r/votifier-client-php",
+        "email": "dev@d3strukt0r.dev",
+        "issues": "https://github.com/Team-MaRo/votifier-client-php/issues",
+        "forum": "https://github.com/Team-MaRo/votifier-client-php/discussions",
+        "wiki": "https://github.com/Team-MaRo/votifier-client-php/wiki",
+        "source": "https://github.com/Team-MaRo/votifier-client-php",
         "docs": "https://votifier-client-php.readthedocs.io"
     },
-    "funding": [
-        {
-            "type": "github",
-            "url": "https://github.com/sponsors/D3strukt0r"
-        },
-        {
-            "type": "patreon",
-            "url": "https://patreon.com/d3strukt0r"
-        }
-    ],
     "require": {
         "php": ">=7.1",
         "ext-SPL": "*",
@@ -45,10 +36,14 @@
         "ext-pcre": "*"
     },
     "require-dev": {
-        "dealerdirect/phpcodesniffer-composer-installer": "0.6.0",
-        "friendsofphp/php-cs-fixer": "^2.16",
+        "dealerdirect/phpcodesniffer-composer-installer": "^1.0",
+        "friendsofphp/php-cs-fixer": "^3.88",
+        "iwf-web/php-coding-standard": "^1.0",
         "phpcompatibility/php-compatibility": "*",
-        "phpunit/phpunit": "^9 || ^8 || ^7",
+        "phpstan/extension-installer": "^1.4",
+        "phpstan/phpstan": "^2.2",
+        "phpstan/phpstan-phpunit": "^2.0",
+        "phpunit/phpunit": "^13 || ^12 || ^11 || ^10 || ^9 || ^8 || ^7",
         "squizlabs/php_codesniffer": "^3.4"
     },
     "autoload": {
@@ -62,33 +57,18 @@
         }
     },
     "config": {
-        "sort-packages": true
+        "sort-packages": true,
+        "allow-plugins": {
+            "dealerdirect/phpcodesniffer-composer-installer": true,
+            "phpstan/extension-installer": true
+        }
     },
     "scripts": {
+        "cs": "php-cs-fixer fix --dry-run --diff -v",
+        "cs:fix": "php-cs-fixer fix",
         "test": "phpunit",
         "check": "phpcs",
-        "check2": "php-cs-fixer fix --diff --dry-run -v",
         "fix": "phpcbf",
-        "fix2": "php-cs-fixer fix"
-    },
-    "archive": {
-        "exclude": [
-            "/.github",
-            "/.idea",
-            "/.vscode",
-            "/docs",
-            "/tests",
-            ".editorconfig",
-            ".gitattributes",
-            ".gitignore",
-            ".php_cs.dist",
-            ".phpcs.xml",
-            ".readthedocs.yml",
-            ".scrutinizer.yml",
-            ".symfony.insight.yaml",
-            "CONTRIBUTING.md",
-            "phpdoc.dist.xml",
-            "phpunit.xml.dist"
-        ]
+        "phpstan": "phpstan analyse"
     }
 }

From f5692b93f7855fef36faa5159e5f90cee53af81d Mon Sep 17 00:00:00 2001
From: D3strukt0r <dev@d3strukt0r.dev>
Date: Mon, 29 Jun 2026 22:55:00 +0200
Subject: [PATCH 12/13] chore: move to the Team-MaRo organization and relicense
 under MIT

Relicense the code from GNU GPL v3 to MIT, update the file headers and repository links to the Team-MaRo organization, refresh the README and project metadata, and stop tracking IDE and editor configuration.
---
 .editorconfig                                 |  52 +-
 .gitattributes                                | 295 +-------
 .gitignore                                    | 216 +-----
 .idea/.gitignore                              |   2 -
 .idea/codeStyles/Project.xml                  |  52 --
 .idea/codeStyles/codeStyleConfig.xml          |   5 -
 .idea/inspectionProfiles/Project_Default.xml  |  23 -
 .idea/misc.xml                                |   6 -
 .idea/modules.xml                             |   8 -
 .idea/php-test-framework.xml                  |  14 -
 .idea/php.xml                                 | 216 ------
 .idea/sensiolabsinsight-analysis-storage.xml  |  11 -
 .idea/sensiolabsinsight-settings.xml          |   7 -
 .idea/sensiolabsinsight-violations.xml        | 177 -----
 .idea/symfony2.xml                            |   6 -
 .idea/vcs.xml                                 |   6 -
 .idea/votifier-client-php.iml                 |  76 --
 .vscode/settings.json                         |   6 -
 AGENTS.md                                     | 156 ++++
 CONTRIBUTING.md                               |  59 --
 LICENSE.txt                                   | 695 +-----------------
 README.md                                     |  77 +-
 src/Exception/NotVotifierException.php        |  10 +-
 .../NuVotifierChallengeInvalidException.php   |  10 +-
 src/Exception/NuVotifierException.php         |  10 +-
 .../NuVotifierSignatureInvalidException.php   |  10 +-
 .../NuVotifierUnknownServiceException.php     |  10 +-
 .../NuVotifierUsernameTooLongException.php    |  10 +-
 .../Socket/NoConnectionException.php          |  10 +-
 .../Socket/PackageNotReceivedException.php    |  10 +-
 .../Socket/PackageNotSentException.php        |  10 +-
 src/Server/GenericServer.php                  |  10 +-
 src/Server/NuVotifier.php                     |  10 +-
 src/Server/ServerInterface.php                |  10 +-
 src/Server/Votifier.php                       |  10 +-
 src/Socket.php                                |  10 +-
 src/Vote/ClassicVote.php                      |  10 +-
 src/Vote/VoteInterface.php                    |  10 +-
 38 files changed, 357 insertions(+), 1968 deletions(-)
 delete mode 100644 .idea/.gitignore
 delete mode 100644 .idea/codeStyles/Project.xml
 delete mode 100644 .idea/codeStyles/codeStyleConfig.xml
 delete mode 100644 .idea/inspectionProfiles/Project_Default.xml
 delete mode 100644 .idea/misc.xml
 delete mode 100644 .idea/modules.xml
 delete mode 100644 .idea/php-test-framework.xml
 delete mode 100644 .idea/php.xml
 delete mode 100644 .idea/sensiolabsinsight-analysis-storage.xml
 delete mode 100644 .idea/sensiolabsinsight-settings.xml
 delete mode 100644 .idea/sensiolabsinsight-violations.xml
 delete mode 100644 .idea/symfony2.xml
 delete mode 100644 .idea/vcs.xml
 delete mode 100644 .idea/votifier-client-php.iml
 delete mode 100644 .vscode/settings.json
 create mode 100644 AGENTS.md
 delete mode 100644 CONTRIBUTING.md

diff --git a/.editorconfig b/.editorconfig
index bdf87ec..3475e4f 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -1,43 +1,31 @@
-# EditorConfig is awesome
-# http://EditorConfig.org
-# This file is based on The Common EditorConfig Template project
-# https://github.com/Lin-Buo-Ren/the-common-editorconfig-template
-# Public Domain
-## Indicate that is the top-most EditorConfig file to search for ##
+# https://editorconfig.org/
 root = true
 
-## Common setting for all files not specified ##
 [*]
-# The character set of the file
-charset = utf-8
-
-# The end of line(EOL) sequence of the file
 end_of_line = lf
-
-# Whether to ensure there's always a single end of line sequence at the end of the file for compatibility of some utilities
+indent_style = space
+indent_size = 2
+charset = utf-8
 insert_final_newline = true
+trim_trailing_whitespace = true
 
-# Determine the actual(Space)/visual(Tab) width of one indentation level
-indent_size = 4
-
-# Determine the default indentation character sequence
-# tab: 1 tab per indentation level
-# space: {indent_size} per indentation level
-indent_style = space
+ij_continuation_indent_size = 2
+ij_visual_guides = 80, 120, 150
 
-# Whether to trim out the (unnecessary) trailing whitespace(s) of the line
-trim_trailing_whitespace = true
+# Avoid git patch fail to apply due to stripped unmodified lines that contains only spaces
+[/.git/**]
+trim_trailing_whitespace = false
 
-## Markdown specific settings ##
-[*.{md,mkd,mkdn,markdown}]
-# Trailing whitespace means manual linebreaks in Markdown thus is not trimmable
+[*.md]
+# Trailing whitespace means manual linebreaks
 trim_trailing_whitespace = false
 
-## YAML specific settings ##
-[*.{yml,yaml}]
-indent_size = 2
+# Don't check indentation size as it can't handle intentional indentation
+# in list item after hardbreaks to align with the node markers, use
+# Markdownlint to check instead
+indent_size = unset
 
-## Git specific settings ##
-# Avoid git patch fail to apply due to the stripped unmodified lines that contains only spaces, which also matches as "trailing spaces"
-[.git/**]
-trim_trailing_whitespace = false
+[{*.php,*.json,*.dist.xml,*.xml.dist}]
+indent_size = 4
+tab_width = 4
+ij_continuation_indent_size = 4
diff --git a/.gitattributes b/.gitattributes
index 5bbbf75..1a1b723 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -1,300 +1,23 @@
-# Created by https://www.richie-bendall.ml/gitattributes-generator/
-
-# Common settings that generally should always be used with your language specific settings
+# See https://www.gitattributes.io/api/web
+# See https://www.richie-bendall.ml/gitattributes-generator/
 
 # Auto detect text files and perform LF normalization
 # https://www.davidlaing.com/2012/09/19/customise-your-gitattributes-to-become-a-git-ninja/
-* text=auto
-
-#
-# The above will handle all files NOT found below
-#
-
-# Documents
-*.bibtex text diff=bibtex
-*.doc diff=astextplain
-*.DOC diff=astextplain
-*.docx diff=astextplain
-*.DOCX diff=astextplain
-*.dot diff=astextplain
-*.DOT diff=astextplain
-*.pdf diff=astextplain
-*.PDF diff=astextplain
-*.rtf diff=astextplain
-*.RTF diff=astextplain
-*.md text
-*.tex text diff=tex
-*.adoc text
-*.textile text
-*.mustache text
-*.csv text
-*.tab text
-*.tsv text
-*.txt text
-*.sql text
-
-# Graphics
-*.png binary
-*.jpg binary
-*.jpeg binary
-*.gif binary
-*.tif binary
-*.tiff binary
-*.ico binary
-# SVG treated as an asset (binary) by default.
-*.svg text
-# If you want to treat it as binary,
-# use the following line instead.
-# *.svg    binary
-*.eps binary
-
-# Scripts
-*.bash text eol=lf
-*.fish text eol=lf
-*.sh text eol=lf
-# These are explicitly windows files and should use crlf
-*.bat text eol=crlf
-*.cmd text eol=crlf
-*.ps1 text eol=crlf
 
-# Serialisation
-*.json text
-*.toml text
-*.xml text
-*.yaml text
-*.yml text
-
-# Archives
-*.7z binary
-*.gz binary
-*.tar binary
-*.tgz binary
-*.zip binary
-
-# Text files where line endings should be preserved
-*.patch -text
-
-#
-# Exclude files from exporting
-#
-.gitattributes export-ignore
-.gitignore export-ignore
-.gitkeep export-ignore
-
-## GITATTRIBUTES FOR WEB PROJECTS
-#
-# These settings are for any web project.
-#
 # Details per file setting:
 #   text    These files should be normalized (i.e. convert CRLF to LF).
 #   binary  These files are binary and should be left untouched.
 #
 # Note that binary is a macro for -text -diff.
-######################################################################
-
-# Auto detect
-##   Handle line endings automatically for files detected as
-##   text and leave all files detected as binary untouched.
-##   This will handle all files NOT defined below.
-* text=auto
-
-# Source code
-*.bash text eol=lf
-*.bat text eol=crlf
-*.cmd text eol=crlf
-*.coffee text
-*.css text
-*.htm text diff=html
-*.html text diff=html
-*.inc text
-*.ini text
-*.js text
-*.json text
-*.jsx text
-*.less text
-*.ls text
-*.map text -diff
-*.od text
-*.onlydata text
-*.php text diff=php
-*.pl text
-*.ps1 text eol=crlf
-*.py text diff=python
-*.rb text diff=ruby
-*.sass text
-*.scm text
-*.scss text diff=css
-*.sh text eol=lf
-*.sql text
-*.styl text
-*.tag text
-*.ts text
-*.tsx text
-*.xml text
-*.xhtml text diff=html
-
-# Docker
-Dockerfile text
-
-# Documentation
-*.ipynb text
-*.markdown text
-*.md text
-*.mdwn text
-*.mdown text
-*.mkd text
-*.mkdn text
-*.mdtxt text
-*.mdtext text
-*.txt text
-AUTHORS text
-CHANGELOG text
-CHANGES text
-CONTRIBUTING text
-COPYING text
-copyright text
-*COPYRIGHT* text
-INSTALL text
-license text
-LICENSE text
-NEWS text
-readme text
-*README* text
-TODO text
-
-# Templates
-*.dot text
-*.ejs text
-*.haml text
-*.handlebars text
-*.hbs text
-*.hbt text
-*.jade text
-*.latte text
-*.mustache text
-*.njk text
-*.phtml text
-*.tmpl text
-*.tpl text
-*.twig text
-*.vue text
-
-# Configs
-*.cnf text
-*.conf text
-*.config text
-.editorconfig text
-.env text
-.gitattributes text
-.gitconfig text
-.htaccess text
-*.lock text -diff
-package-lock.json text -diff
-*.toml text
-*.yaml text
-*.yml text
-browserslist text
-Makefile text
-makefile text
-
-# Heroku
-Procfile text
-
-# Graphics
-*.ai binary
-*.bmp binary
-*.eps binary
-*.gif binary
-*.gifv binary
-*.ico binary
-*.jng binary
-*.jp2 binary
-*.jpg binary
-*.jpeg binary
-*.jpx binary
-*.jxr binary
-*.pdf binary
-*.png binary
-*.psb binary
-*.psd binary
-# SVG treated as an asset (binary) by default.
-*.svg text
-# If you want to treat it as binary,
-# use the following line instead.
-# *.svg           binary
-*.svgz binary
-*.tif binary
-*.tiff binary
-*.wbmp binary
-*.webp binary
-
-# Audio
-*.kar binary
-*.m4a binary
-*.mid binary
-*.midi binary
-*.mp3 binary
-*.ogg binary
-*.ra binary
-
-# Video
-*.3gpp binary
-*.3gp binary
-*.as binary
-*.asf binary
-*.asx binary
-*.fla binary
-*.flv binary
-*.m4v binary
-*.mng binary
-*.mov binary
-*.mp4 binary
-*.mpeg binary
-*.mpg binary
-*.ogv binary
-*.swc binary
-*.swf binary
-*.webm binary
-
-# Archives
-*.7z binary
-*.gz binary
-*.jar binary
-*.rar binary
-*.tar binary
-*.zip binary
-
-# Fonts
-*.ttf binary
-*.eot binary
-*.otf binary
-*.woff binary
-*.woff2 binary
-
-# Executables
-*.exe binary
-*.pyc binary
 
-# RC files (like .babelrc or .eslintrc)
-*.*rc text
+* export-ignore
 
-# Ignore files (like .npmignore or .gitignore)
-*.*ignore text
+/src/ -export-ignore
+/src/** -export-ignore
 
-# End of https://www.richie-bendall.ml/gitattributes-generator/
+/composer.json -export-ignore
 
-*.php eol=lf
+/CHANGELOG.md -export-ignore
+/LICENSE.txt -export-ignore
+/README.md -export-ignore
 
-.github export-ignore
-.idea export-ignore
-.vscode export-ignore
-docs export-ignore
-tests export-ignore
-.editorconfig export-ignore
-.php_cs.dist export-ignore
-.phpcs.xml export-ignore
-.readthedocs.yml export-ignore
-.scrutinizer.yml export-ignore
-.symfony.insight.yaml export-ignore
-phpdoc.dist.xml export-ignore
-phpunit.xml.dist export-ignore
diff --git a/.gitignore b/.gitignore
index f63923c..95d286f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,166 +1,14 @@
-# Created by https://www.toptal.com/developers/gitignore/api/linux,macos,phpunit,windows,composer,phpstorm,phpcodesniffer
-# Edit at https://www.toptal.com/developers/gitignore?templates=linux,macos,phpunit,windows,composer,phpstorm,phpcodesniffer
+# Example
+# - https://www.toptal.com/developers/gitignore/api/linux,macos,phpunit,windows,composer,phpstorm,phpcodesniffer
+# - https://www.toptal.com/developers/gitignore?templates=linux,macos,phpunit,windows,composer,phpstorm,phpcodesniffer
 
 ### Composer ###
-composer.phar
 /vendor/
 
 # Commit your application's lock file https://getcomposer.org/doc/01-basic-usage.md#commit-your-composer-lock-file-to-version-control
 # You may choose to ignore a library lock file http://getcomposer.org/doc/02-libraries.md#lock-file
 composer.lock
 
-### Linux ###
-*~
-
-# temporary files which can be created if a process still has a handle open of a deleted file
-.fuse_hidden*
-
-# KDE directory preferences
-.directory
-
-# Linux trash folder which might appear on any partition or disk
-.Trash-*
-
-# .nfs files are created when an open file is removed but is still being accessed
-.nfs*
-
-### macOS ###
-# General
-.DS_Store
-.AppleDouble
-.LSOverride
-
-# Icon must end with two \r
-Icon
-
-# Thumbnails
-._*
-
-# Files that might appear in the root of a volume
-.DocumentRevisions-V100
-.fseventsd
-.Spotlight-V100
-.TemporaryItems
-.Trashes
-.VolumeIcon.icns
-.com.apple.timemachine.donotpresent
-
-# Directories potentially created on remote AFP share
-.AppleDB
-.AppleDesktop
-Network Trash Folder
-Temporary Items
-.apdisk
-
-### PHPCodeSniffer ###
-# CodeSniffer
-
-/vendor/*
-/wpcs/*
-
-### PhpStorm ###
-# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
-# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
-
-# User-specific stuff
-.idea/**/workspace.xml
-.idea/**/tasks.xml
-.idea/**/usage.statistics.xml
-.idea/**/dictionaries
-.idea/**/shelf
-
-# Generated files
-.idea/**/contentModel.xml
-
-# Sensitive or high-churn files
-.idea/**/dataSources/
-.idea/**/dataSources.ids
-.idea/**/dataSources.local.xml
-.idea/**/sqlDataSources.xml
-.idea/**/dynamic.xml
-.idea/**/uiDesigner.xml
-.idea/**/dbnavigator.xml
-
-# Gradle
-.idea/**/gradle.xml
-.idea/**/libraries
-
-# Gradle and Maven with auto-import
-# When using Gradle or Maven with auto-import, you should exclude module files,
-# since they will be recreated, and may cause churn.  Uncomment if using
-# auto-import.
-# .idea/artifacts
-# .idea/compiler.xml
-# .idea/jarRepositories.xml
-# .idea/modules.xml
-# .idea/*.iml
-# .idea/modules
-# *.iml
-# *.ipr
-
-# CMake
-cmake-build-*/
-
-# Mongo Explorer plugin
-.idea/**/mongoSettings.xml
-
-# File-based project format
-*.iws
-
-# IntelliJ
-out/
-
-# mpeltonen/sbt-idea plugin
-.idea_modules/
-
-# JIRA plugin
-atlassian-ide-plugin.xml
-
-# Cursive Clojure plugin
-.idea/replstate.xml
-
-# Crashlytics plugin (for Android Studio and IntelliJ)
-com_crashlytics_export_strings.xml
-crashlytics.properties
-crashlytics-build.properties
-fabric.properties
-
-# Editor-based Rest Client
-.idea/httpRequests
-
-# Android studio 3.1+ serialized cache file
-.idea/caches/build_file_checksums.ser
-
-### PhpStorm Patch ###
-# Comment Reason: https://github.com/joeblau/gitignore.io/issues/186#issuecomment-215987721
-
-# *.iml
-# modules.xml
-# .idea/misc.xml
-# *.ipr
-
-# Sonarlint plugin
-# https://plugins.jetbrains.com/plugin/7973-sonarlint
-.idea/**/sonarlint/
-
-# SonarQube Plugin
-# https://plugins.jetbrains.com/plugin/7238-sonarqube-community-plugin
-.idea/**/sonarIssues.xml
-
-# Markdown Navigator plugin
-# https://plugins.jetbrains.com/plugin/7896-markdown-navigator-enhanced
-.idea/**/markdown-navigator.xml
-.idea/**/markdown-navigator-enh.xml
-.idea/**/markdown-navigator/
-
-# Cache file creation bug
-# See https://youtrack.jetbrains.com/issue/JBR-2257
-.idea/$CACHE_FILE$
-
-# CodeStream plugin
-# https://plugins.jetbrains.com/plugin/12206-codestream
-.idea/codestream.xml
-
 ### PHPUnit ###
 # Covers PHPUnit
 # Reference: https://phpunit.de/
@@ -169,57 +17,47 @@ fabric.properties
 .phpunit.result.cache
 
 # PHPUnit
-/app/phpunit.xml
 /phpunit.xml
 
-# Build data
-/build/
-
-### Windows ###
-# Windows thumbnail cache files
-Thumbs.db
-Thumbs.db:encryptable
-ehthumbs.db
-ehthumbs_vista.db
-
-# Dump file
-*.stackdump
-
-# Folder config file
-[Dd]esktop.ini
-
-# Recycle Bin used on file shares
-$RECYCLE.BIN/
-
-# Windows Installer files
-*.cab
-*.msi
-*.msix
-*.msm
-*.msp
-
-# Windows shortcuts
-*.lnk
-
-# End of https://www.toptal.com/developers/gitignore/api/linux,macos,phpunit,windows,composer,phpstorm,phpcodesniffer
-
 # Coverage report by PhpUnit
 /coverage/
 
+### IDE ###
+.idea/
+
+### Docs ###
 # Sphinx documentation
 /docs/build/
 
+# Python bytecode cache (docs/update-license.py)
+__pycache__/
+*.pyc
+
+# Formatted license generated at build time by docs/update-license.py
+# (the plain-text original is committed as docs/LICENSE.txt)
+/docs/LICENSE.rst
+
 # phpDocumentor
 /.phpdoc
 /api
 phpdoc.xml
 
+### Code Style ###
 # PHP CodeSniffer
 .php_codesniffer_cache.json
 
 # PHP Coding Standards fixer
-.php_cs
-.php_coding_standard_cache.json
+.php-cs-fixer.cache
 
+### Other ###
 # Testing
 ManualTest.php
+
+# Server
+/server
+
+# Dependencies of the standalone end-to-end test server (its own composer island)
+/public/vendor/
+
+# AI agent guidance — AGENTS.md is the tracked source of truth; CLAUDE.md is a local pointer
+/CLAUDE.md
diff --git a/.idea/.gitignore b/.idea/.gitignore
deleted file mode 100644
index e7e9d11..0000000
--- a/.idea/.gitignore
+++ /dev/null
@@ -1,2 +0,0 @@
-# Default ignored files
-/workspace.xml
diff --git a/.idea/codeStyles/Project.xml b/.idea/codeStyles/Project.xml
deleted file mode 100644
index 6ed64a2..0000000
--- a/.idea/codeStyles/Project.xml
+++ /dev/null
@@ -1,52 +0,0 @@
-<component name="ProjectCodeStyleConfiguration">
-  <code_scheme name="Project" version="173">
-    <PHPCodeStyleSettings>
-      <option name="ALIGN_PHPDOC_PARAM_NAMES" value="true" />
-      <option name="ALIGN_PHPDOC_COMMENTS" value="true" />
-      <option name="COMMA_AFTER_LAST_ARRAY_ELEMENT" value="true" />
-      <option name="PHPDOC_BLANK_LINE_BEFORE_TAGS" value="true" />
-      <option name="PHPDOC_BLANK_LINES_AROUND_PARAMETERS" value="true" />
-      <option name="PHPDOC_WRAP_LONG_LINES" value="true" />
-      <option name="BLANK_LINES_BETWEEN_IMPORTS" value="1" />
-      <option name="THROWS_WEIGHT" value="1" />
-      <option name="RETURN_WEIGHT" value="2" />
-      <option name="LOWER_CASE_BOOLEAN_CONST" value="true" />
-      <option name="LOWER_CASE_NULL_CONST" value="true" />
-      <option name="ELSE_IF_STYLE" value="COMBINE" />
-      <option name="VARIABLE_NAMING_STYLE" value="CAMEL_CASE" />
-      <option name="KEEP_RPAREN_AND_LBRACE_ON_ONE_LINE" value="true" />
-      <option name="BLANK_LINES_AFTER_OPENING_TAG" value="1" />
-      <option name="KEEP_BLANK_LINES_AFTER_LBRACE" value="0" />
-      <option name="FORCE_SHORT_DECLARATION_ARRAY_STYLE" value="true" />
-      <option name="NEW_LINE_AFTER_PHP_OPENING_TAG" value="true" />
-      <option name="MULTILINE_CHAINED_CALLS_SEMICOLON_ON_NEW_LINE" value="true" />
-    </PHPCodeStyleSettings>
-    <XML>
-      <option name="XML_SPACE_INSIDE_EMPTY_TAG" value="true" />
-    </XML>
-    <codeStyleSettings language="PHP">
-      <option name="KEEP_BLANK_LINES_BEFORE_RBRACE" value="0" />
-      <option name="BLANK_LINES_AFTER_PACKAGE" value="1" />
-      <option name="ALIGN_MULTILINE_PARAMETERS" value="false" />
-      <option name="ALIGN_MULTILINE_PARAMETERS_IN_CALLS" value="true" />
-      <option name="ALIGN_MULTILINE_EXTENDS_LIST" value="true" />
-      <option name="SPACE_AFTER_TYPE_CAST" value="true" />
-      <option name="CALL_PARAMETERS_WRAP" value="5" />
-      <option name="CALL_PARAMETERS_LPAREN_ON_NEXT_LINE" value="true" />
-      <option name="CALL_PARAMETERS_RPAREN_ON_NEXT_LINE" value="true" />
-      <option name="METHOD_PARAMETERS_WRAP" value="5" />
-      <option name="METHOD_PARAMETERS_LPAREN_ON_NEXT_LINE" value="true" />
-      <option name="METHOD_PARAMETERS_RPAREN_ON_NEXT_LINE" value="true" />
-      <option name="EXTENDS_LIST_WRAP" value="5" />
-      <option name="FOR_STATEMENT_LPAREN_ON_NEXT_LINE" value="true" />
-      <option name="FOR_STATEMENT_RPAREN_ON_NEXT_LINE" value="true" />
-      <option name="ARRAY_INITIALIZER_WRAP" value="5" />
-      <option name="ARRAY_INITIALIZER_LBRACE_ON_NEXT_LINE" value="true" />
-      <option name="ARRAY_INITIALIZER_RBRACE_ON_NEXT_LINE" value="true" />
-      <option name="IF_BRACE_FORCE" value="3" />
-      <option name="DOWHILE_BRACE_FORCE" value="3" />
-      <option name="WHILE_BRACE_FORCE" value="3" />
-      <option name="FOR_BRACE_FORCE" value="3" />
-    </codeStyleSettings>
-  </code_scheme>
-</component>
\ No newline at end of file
diff --git a/.idea/codeStyles/codeStyleConfig.xml b/.idea/codeStyles/codeStyleConfig.xml
deleted file mode 100644
index 79ee123..0000000
--- a/.idea/codeStyles/codeStyleConfig.xml
+++ /dev/null
@@ -1,5 +0,0 @@
-<component name="ProjectCodeStyleConfiguration">
-  <state>
-    <option name="USE_PER_PROJECT_SETTINGS" value="true" />
-  </state>
-</component>
\ No newline at end of file
diff --git a/.idea/inspectionProfiles/Project_Default.xml b/.idea/inspectionProfiles/Project_Default.xml
deleted file mode 100644
index 5f17a75..0000000
--- a/.idea/inspectionProfiles/Project_Default.xml
+++ /dev/null
@@ -1,23 +0,0 @@
-<component name="InspectionProjectProfileManager">
-  <profile version="1.0">
-    <option name="myName" value="Project Default" />
-    <inspection_tool class="PhpCSFixerValidationInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true">
-      <option name="CODING_STANDARD" value="Custom" />
-      <option name="CUSTOM_RULESET_PATH" value="$PROJECT_DIR$/.php_cs.dist" />
-      <option name="ALLOW_RISKY_RULES" value="true" />
-    </inspection_tool>
-    <inspection_tool class="PhpCSValidationInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true">
-      <option name="CODING_STANDARD" value="Custom" />
-      <option name="CUSTOM_RULESET_PATH" value="$PROJECT_DIR$/.phpcs.xml" />
-      <option name="EXTENSIONS" value="php,js,css,inc" />
-    </inspection_tool>
-    <inspection_tool class="PhpCompoundNamespaceDepthInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
-    <inspection_tool class="PhpLongTypeFormInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
-    <inspection_tool class="PhpMissingVisibilityInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
-    <inspection_tool class="PhpModifierOrderInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
-    <inspection_tool class="PhpNewClassMissingParameterListInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
-    <inspection_tool class="PhpSeparateElseIfInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
-    <inspection_tool class="PhpTraitsUseListInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
-    <inspection_tool class="PhpVarUsageInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
-  </profile>
-</component>
\ No newline at end of file
diff --git a/.idea/misc.xml b/.idea/misc.xml
deleted file mode 100644
index 28a804d..0000000
--- a/.idea/misc.xml
+++ /dev/null
@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="JavaScriptSettings">
-    <option name="languageLevel" value="ES6" />
-  </component>
-</project>
\ No newline at end of file
diff --git a/.idea/modules.xml b/.idea/modules.xml
deleted file mode 100644
index 8476cc9..0000000
--- a/.idea/modules.xml
+++ /dev/null
@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectModuleManager">
-    <modules>
-      <module fileurl="file://$PROJECT_DIR$/.idea/votifier-client-php.iml" filepath="$PROJECT_DIR$/.idea/votifier-client-php.iml" />
-    </modules>
-  </component>
-</project>
\ No newline at end of file
diff --git a/.idea/php-test-framework.xml b/.idea/php-test-framework.xml
deleted file mode 100644
index 520aef8..0000000
--- a/.idea/php-test-framework.xml
+++ /dev/null
@@ -1,14 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="PhpTestFrameworkVersionCache">
-    <tools_cache>
-      <tool tool_name="PHPUnit">
-        <cache>
-          <versions>
-            <info id="Local" version="9.3.8" />
-          </versions>
-        </cache>
-      </tool>
-    </tools_cache>
-  </component>
-</project>
\ No newline at end of file
diff --git a/.idea/php.xml b/.idea/php.xml
deleted file mode 100644
index f9c03e1..0000000
--- a/.idea/php.xml
+++ /dev/null
@@ -1,216 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="PhpCSFixer">
-    <phpcsfixer_settings>
-      <PhpCSFixerConfiguration standards="PSR1;PSR2;Symfony;DoctrineAnnotation;PHP70Migration;PHP71Migration" tool_path="$PROJECT_DIR$/vendor/bin/php-cs-fixer" />
-    </phpcsfixer_settings>
-  </component>
-  <component name="PhpCodeSniffer">
-    <phpcs_settings>
-      <PhpCSConfiguration beautifier_path="$PROJECT_DIR$/vendor/bin/phpcbf" standards="MySource;PEAR;PSR1;PSR12;PSR2;Squiz;Zend" tool_path="$PROJECT_DIR$/vendor/bin/phpcs" />
-    </phpcs_settings>
-  </component>
-  <component name="PhpIncludePathManager">
-    <include_path>
-      <path value="$PROJECT_DIR$/vendor/psr/container" />
-      <path value="$PROJECT_DIR$/vendor/psr/log" />
-      <path value="$PROJECT_DIR$/vendor/myclabs/deep-copy" />
-      <path value="$PROJECT_DIR$/vendor/phar-io/manifest" />
-      <path value="$PROJECT_DIR$/vendor/phar-io/version" />
-      <path value="$PROJECT_DIR$/vendor/phpspec/prophecy" />
-      <path value="$PROJECT_DIR$/vendor/phpunit/php-code-coverage" />
-      <path value="$PROJECT_DIR$/vendor/phpunit/php-file-iterator" />
-      <path value="$PROJECT_DIR$/vendor/phpunit/php-text-template" />
-      <path value="$PROJECT_DIR$/vendor/phpunit/php-timer" />
-      <path value="$PROJECT_DIR$/vendor/phpunit/phpunit" />
-      <path value="$PROJECT_DIR$/vendor/symfony/console" />
-      <path value="$PROJECT_DIR$/vendor/symfony/filesystem" />
-      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-ctype" />
-      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-mbstring" />
-      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php73" />
-      <path value="$PROJECT_DIR$/vendor/symfony/process" />
-      <path value="$PROJECT_DIR$/vendor/symfony/service-contracts" />
-      <path value="$PROJECT_DIR$/vendor/symfony/stopwatch" />
-      <path value="$PROJECT_DIR$/vendor/theseer/tokenizer" />
-      <path value="$PROJECT_DIR$/vendor/doctrine/annotations" />
-      <path value="$PROJECT_DIR$/vendor/doctrine/instantiator" />
-      <path value="$PROJECT_DIR$/vendor/doctrine/lexer" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/code-unit-reverse-lookup" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/comparator" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/diff" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/environment" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/exporter" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/global-state" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/object-enumerator" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/object-reflector" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/recursion-context" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/resource-operations" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/type" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/version" />
-      <path value="$PROJECT_DIR$/vendor/squizlabs/php_codesniffer" />
-      <path value="$PROJECT_DIR$/vendor/webmozart/assert" />
-      <path value="$PROJECT_DIR$/vendor/phpdocumentor/reflection-common" />
-      <path value="$PROJECT_DIR$/vendor/phpdocumentor/reflection-docblock" />
-      <path value="$PROJECT_DIR$/vendor/phpdocumentor/type-resolver" />
-      <path value="$PROJECT_DIR$/vendor/composer" />
-      <path value="$PROJECT_DIR$/vendor/phpunit/php-invoker" />
-      <path value="$PROJECT_DIR$/vendor/paragonie/random_compat" />
-      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php72" />
-      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php70" />
-      <path value="$PROJECT_DIR$/vendor/friendsofphp/php-cs-fixer" />
-      <path value="$PROJECT_DIR$/vendor/psr/event-dispatcher" />
-      <path value="$PROJECT_DIR$/vendor/php-cs-fixer/diff" />
-      <path value="$PROJECT_DIR$/vendor/symfony/event-dispatcher-contracts" />
-      <path value="$PROJECT_DIR$/vendor/symfony/event-dispatcher" />
-      <path value="$PROJECT_DIR$/vendor/symfony/options-resolver" />
-      <path value="$PROJECT_DIR$/vendor/symfony/finder" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/code-unit" />
-      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php80" />
-      <path value="$PROJECT_DIR$/vendor/symfony/deprecation-contracts" />
-      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-intl-normalizer" />
-      <path value="$PROJECT_DIR$/vendor/symfony/string" />
-      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-intl-grapheme" />
-      <path value="$PROJECT_DIR$/vendor/phpcompatibility/php-compatibility" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/complexity" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/cli-parser" />
-      <path value="$PROJECT_DIR$/vendor/sebastian/lines-of-code" />
-      <path value="$PROJECT_DIR$/vendor/nikic/php-parser" />
-      <path value="$PROJECT_DIR$/vendor/dealerdirect/phpcodesniffer-composer-installer" />
-    </include_path>
-  </component>
-  <component name="PhpProjectSharedConfiguration" php_language_level="7.1" />
-  <component name="PhpRuntimeConfiguration">
-    <extensions>
-      <extension name="Ev" enabled="false" />
-      <extension name="PDO" enabled="false" />
-      <extension name="Phar" enabled="false" />
-      <extension name="Reflection" enabled="false" />
-      <extension name="SQLite" enabled="false" />
-      <extension name="SimpleXML" enabled="false" />
-      <extension name="SplType" enabled="false" />
-      <extension name="Zend OPcache" enabled="false" />
-      <extension name="ZendDebugger" enabled="false" />
-      <extension name="ZendUtils" enabled="false" />
-      <extension name="amqp" enabled="false" />
-      <extension name="apache" enabled="false" />
-      <extension name="apcu" enabled="false" />
-      <extension name="bcmath" enabled="false" />
-      <extension name="bz2" enabled="false" />
-      <extension name="calendar" enabled="false" />
-      <extension name="cassandra" enabled="false" />
-      <extension name="couchbase" enabled="false" />
-      <extension name="ctype" enabled="false" />
-      <extension name="cubrid" enabled="false" />
-      <extension name="curl" enabled="false" />
-      <extension name="dba" enabled="false" />
-      <extension name="decimal" enabled="false" />
-      <extension name="dom" enabled="false" />
-      <extension name="enchant" enabled="false" />
-      <extension name="exif" enabled="false" />
-      <extension name="fann" enabled="false" />
-      <extension name="ffmpeg" enabled="false" />
-      <extension name="fileinfo" enabled="false" />
-      <extension name="filter" enabled="false" />
-      <extension name="fpm" enabled="false" />
-      <extension name="ftp" enabled="false" />
-      <extension name="gd" enabled="false" />
-      <extension name="gearman" enabled="false" />
-      <extension name="geoip" enabled="false" />
-      <extension name="geos" enabled="false" />
-      <extension name="gettext" enabled="false" />
-      <extension name="gmagick" enabled="false" />
-      <extension name="gmp" enabled="false" />
-      <extension name="gnupg" enabled="false" />
-      <extension name="grpc" enabled="false" />
-      <extension name="http" enabled="false" />
-      <extension name="ibm_db2" enabled="false" />
-      <extension name="iconv" enabled="false" />
-      <extension name="igbinary" enabled="false" />
-      <extension name="imagick" enabled="false" />
-      <extension name="imap" enabled="false" />
-      <extension name="inotify" enabled="false" />
-      <extension name="interbase" enabled="false" />
-      <extension name="intl" enabled="false" />
-      <extension name="judy" enabled="false" />
-      <extension name="ldap" enabled="false" />
-      <extension name="libevent" enabled="false" />
-      <extension name="libsodium" enabled="false" />
-      <extension name="libxml" enabled="false" />
-      <extension name="mailparse" enabled="false" />
-      <extension name="mcrypt" enabled="false" />
-      <extension name="memcache" enabled="false" />
-      <extension name="memcached" enabled="false" />
-      <extension name="meta" enabled="false" />
-      <extension name="ming" enabled="false" />
-      <extension name="mongo" enabled="false" />
-      <extension name="mongodb" enabled="false" />
-      <extension name="mosquitto-php" enabled="false" />
-      <extension name="mqseries" enabled="false" />
-      <extension name="mssql" enabled="false" />
-      <extension name="mysql" enabled="false" />
-      <extension name="mysql_xdevapi" enabled="false" />
-      <extension name="mysqli" enabled="false" />
-      <extension name="ncurses" enabled="false" />
-      <extension name="newrelic" enabled="false" />
-      <extension name="oauth" enabled="false" />
-      <extension name="oci8" enabled="false" />
-      <extension name="odbc" enabled="false" />
-      <extension name="pcntl" enabled="false" />
-      <extension name="pdflib" enabled="false" />
-      <extension name="pdo_ibm" enabled="false" />
-      <extension name="pdo_mysql" enabled="false" />
-      <extension name="pdo_pgsql" enabled="false" />
-      <extension name="pdo_sqlite" enabled="false" />
-      <extension name="pgsql" enabled="false" />
-      <extension name="posix" enabled="false" />
-      <extension name="pspell" enabled="false" />
-      <extension name="pthreads" enabled="false" />
-      <extension name="radius" enabled="false" />
-      <extension name="rar" enabled="false" />
-      <extension name="readline" enabled="false" />
-      <extension name="recode" enabled="false" />
-      <extension name="redis" enabled="false" />
-      <extension name="regex" enabled="false" />
-      <extension name="rrd" enabled="false" />
-      <extension name="session" enabled="false" />
-      <extension name="shmop" enabled="false" />
-      <extension name="snmp" enabled="false" />
-      <extension name="soap" enabled="false" />
-      <extension name="sockets" enabled="false" />
-      <extension name="sodium" enabled="false" />
-      <extension name="sqlite3" enabled="false" />
-      <extension name="sqlsrv" enabled="false" />
-      <extension name="ssh2" enabled="false" />
-      <extension name="suhosin" enabled="false" />
-      <extension name="superglobals" enabled="false" />
-      <extension name="svn" enabled="false" />
-      <extension name="sybase" enabled="false" />
-      <extension name="sysvmsg" enabled="false" />
-      <extension name="sysvsem" enabled="false" />
-      <extension name="sysvshm" enabled="false" />
-      <extension name="tidy" enabled="false" />
-      <extension name="tokenizer" enabled="false" />
-      <extension name="v8js" enabled="false" />
-      <extension name="wddx" enabled="false" />
-      <extension name="win32service" enabled="false" />
-      <extension name="wincache" enabled="false" />
-      <extension name="xdebug" enabled="false" />
-      <extension name="xhprof" enabled="false" />
-      <extension name="xml" enabled="false" />
-      <extension name="xmlreader" enabled="false" />
-      <extension name="xmlrpc" enabled="false" />
-      <extension name="xmlwriter" enabled="false" />
-      <extension name="xsl" enabled="false" />
-      <extension name="yaml" enabled="false" />
-      <extension name="zend" enabled="false" />
-      <extension name="zip" enabled="false" />
-      <extension name="zlib" enabled="false" />
-      <extension name="zmq" enabled="false" />
-    </extensions>
-  </component>
-  <component name="PhpUnit">
-    <phpunit_settings>
-      <PhpUnitSettings configuration_file_path="$PROJECT_DIR$/phpunit.xml.dist" custom_loader_path="$PROJECT_DIR$/vendor/autoload.php" use_configuration_file="true" />
-    </phpunit_settings>
-  </component>
-</project>
\ No newline at end of file
diff --git a/.idea/sensiolabsinsight-analysis-storage.xml b/.idea/sensiolabsinsight-analysis-storage.xml
deleted file mode 100644
index b5641c8..0000000
--- a/.idea/sensiolabsinsight-analysis-storage.xml
+++ /dev/null
@@ -1,11 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="SensioLabsInsightAnalysisStorage">
-    <option name="analysesList">
-      <list>
-        <InsightAnalysis duration="12" href="https://insight.sensiolabs.com/api/projects/bd3d1f70-187d-4717-9d8e-83f5fa408e21/analyses/2" nbViolations="4" nextGrade="GOLD" number="2" reference="991eaed501fce2475f27016ada485d827111b9b4" remediationCostForNextGrade="-1" status="finished" />
-        <InsightAnalysis duration="12" href="https://insight.sensiolabs.com/api/projects/bd3d1f70-187d-4717-9d8e-83f5fa408e21/analyses/1" nbViolations="14" nextGrade="GOLD" number="1" reference="61f7fa0f78cead3fca504e1bc82bb00d39b224ed" remediationCostForNextGrade="-1" status="finished" />
-      </list>
-    </option>
-  </component>
-</project>
\ No newline at end of file
diff --git a/.idea/sensiolabsinsight-settings.xml b/.idea/sensiolabsinsight-settings.xml
deleted file mode 100644
index 206d1c8..0000000
--- a/.idea/sensiolabsinsight-settings.xml
+++ /dev/null
@@ -1,7 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="SensioLabsInsightSettings">
-    <option name="projectUuid" value="bd3d1f70-187d-4717-9d8e-83f5fa408e21" />
-    <option name="projectName" value="votifier-client-php" />
-  </component>
-</project>
\ No newline at end of file
diff --git a/.idea/sensiolabsinsight-violations.xml b/.idea/sensiolabsinsight-violations.xml
deleted file mode 100644
index 5870b4e..0000000
--- a/.idea/sensiolabsinsight-violations.xml
+++ /dev/null
@@ -1,177 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<analysis>
-  <link href="https://insight.sensiolabs.com/api/projects/bd3d1f70-187d-4717-9d8e-83f5fa408e21/analyses/2" rel="self" type="application/vnd.com.sensiolabs.insight+xml"/>
-  <link href="https://insight.sensiolabs.com/api/projects/bd3d1f70-187d-4717-9d8e-83f5fa408e21/analyses/2/status" rel="status" type="application/vnd.com.sensiolabs.insight+xml"/>
-  <link href="https://insight.sensiolabs.com/api/projects/bd3d1f70-187d-4717-9d8e-83f5fa408e21" rel="project" type="application/vnd.com.sensiolabs.insight+xml"/>
-  <link href="https://insight.sensiolabs.com/projects/bd3d1f70-187d-4717-9d8e-83f5fa408e21/analyses/2" rel="self" type="text/html"/>
-  <status><![CDATA[finished]]></status>
-  <violations>
-    <violation severity="minor" category="codestyle" ignored="false">
-      <line>29</line>
-      <resource><![CDATA[.gitignore]]></resource>
-      <title>Your project gitignore file should not contain user-specific files</title>
-      <message><![CDATA[.DS_Store is user-specific and should not appear in a project .gitignore. Consider adding it to the user global .gitignore instead.]]></message>
-      <context start-line="24" end-line="34"><![CDATA[# .nfs files are created when an open file is removed but is still being accessed
-.nfs*
-
-### macOS ###
-# General
-.DS_Store
-.AppleDouble
-.LSOverride
-
-# Icon must end with two \r
-Icon]]></context>
-      <link href="https://insight.sensiolabs.com/projects/bd3d1f70-187d-4717-9d8e-83f5fa408e21/analyses/2?status=new#892780836" rel="self" type="text/html"/>
-    </violation>
-    <violation severity="minor" category="codestyle" ignored="false">
-      <line>34</line>
-      <resource><![CDATA[.gitignore]]></resource>
-      <title>Your project gitignore file should not contain user-specific files</title>
-      <message><![CDATA[Icon is user-specific and should not appear in a project .gitignore. Consider adding it to the user global .gitignore instead.]]></message>
-      <context start-line="29" end-line="39"><![CDATA[.DS_Store
-.AppleDouble
-.LSOverride
-
-# Icon must end with two \r
-Icon
-
-# Thumbnails
-._*
-
-# Files that might appear in the root of a volume]]></context>
-      <link href="https://insight.sensiolabs.com/projects/bd3d1f70-187d-4717-9d8e-83f5fa408e21/analyses/2?status=new#892780837" rel="self" type="text/html"/>
-    </violation>
-    <violation severity="minor" category="codestyle" ignored="false">
-      <line>180</line>
-      <resource><![CDATA[.gitignore]]></resource>
-      <title>Your project gitignore file should not contain user-specific files</title>
-      <message><![CDATA[Thumbs.db is user-specific and should not appear in a project .gitignore. Consider adding it to the user global .gitignore instead.]]></message>
-      <context start-line="175" end-line="185"><![CDATA[# Build data
-/build/
-
-### Windows ###
-# Windows thumbnail cache files
-Thumbs.db
-Thumbs.db:encryptable
-ehthumbs.db
-ehthumbs_vista.db
-
-# Dump file]]></context>
-      <link href="https://insight.sensiolabs.com/projects/bd3d1f70-187d-4717-9d8e-83f5fa408e21/analyses/2?status=new#892780839" rel="self" type="text/html"/>
-    </violation>
-    <violation severity="minor" category="codestyle" ignored="false">
-      <line>182</line>
-      <resource><![CDATA[.gitignore]]></resource>
-      <title>Your project gitignore file should not contain user-specific files</title>
-      <message><![CDATA[ehthumbs.db is user-specific and should not appear in a project .gitignore. Consider adding it to the user global .gitignore instead.]]></message>
-      <context start-line="177" end-line="187"><![CDATA[
-### Windows ###
-# Windows thumbnail cache files
-Thumbs.db
-Thumbs.db:encryptable
-ehthumbs.db
-ehthumbs_vista.db
-
-# Dump file
-*.stackdump
-]]></context>
-      <link href="https://insight.sensiolabs.com/projects/bd3d1f70-187d-4717-9d8e-83f5fa408e21/analyses/2?status=new#892780838" rel="self" type="text/html"/>
-    </violation>
-  </violations>
-  <grades>
-    <entry><![CDATA[none]]></entry>
-    <entry><![CDATA[bronze]]></entry>
-    <entry><![CDATA[silver]]></entry>
-    <entry><![CDATA[gold]]></entry>
-    <entry><![CDATA[platinum]]></entry>
-  </grades>
-  <failed>false</failed>
-  <grade><![CDATA[silver]]></grade>
-  <next-grade><![CDATA[gold]]></next-grade>
-  <begin-at><![CDATA[2020-09-12T23:32:35+0000]]></begin-at>
-  <end-at><![CDATA[2020-09-12T23:34:31+0000]]></end-at>
-  <duration>12</duration>
-  <number>2</number>
-  <altered>false</altered>
-  <remediation-cost>1</remediation-cost>
-  <nb-violations>4</nb-violations>
-  <reference><![CDATA[991eaed501fce2475f27016ada485d827111b9b4]]></reference>
-  <launched-by><![CDATA[xlpixel]]></launched-by>
-  <configuration>
-    <ignored-branches>
-      <branch><![CDATA[gh-pages]]></branch>
-    </ignored-branches>
-    <pre-composer-script/>
-    <post-composer-script/>
-    <working-directory/>
-    <php-version/>
-    <php-ini/>
-    <commit-failure-conditions>
-      <branch><![CDATA[project.severity.critical > 0]]></branch>
-      <branch><![CDATA[project.severity.major > 0]]></branch>
-    </commit-failure-conditions>
-    <global-excluded-dirs>
-      <dir><![CDATA[vendor]]></dir>
-      <dir><![CDATA[vendors]]></dir>
-      <dir><![CDATA[test]]></dir>
-      <dir><![CDATA[tests]]></dir>
-      <dir><![CDATA[Tests]]></dir>
-      <dir><![CDATA[spec]]></dir>
-      <dir><![CDATA[features]]></dir>
-      <dir><![CDATA[Fixtures]]></dir>
-      <dir><![CDATA[DataFixtures]]></dir>
-      <dir><![CDATA[var]]></dir>
-    </global-excluded-dirs>
-    <excluded-patterns>
-      <pattern><![CDATA[app/check.php]]></pattern>
-      <pattern><![CDATA[app/SymfonyRequirements.php]]></pattern>
-      <pattern><![CDATA[public/index.php]]></pattern>
-      <pattern><![CDATA[web/config.php]]></pattern>
-      <pattern><![CDATA[web/app_*.php]]></pattern>
-      <pattern><![CDATA[config/bootstrap.php]]></pattern>
-    </excluded-patterns>
-    <patterns>
-      <file>
-        <pattern><![CDATA[*.php]]></pattern>
-        <pattern><![CDATA[*.twig]]></pattern>
-        <pattern><![CDATA[*.xml]]></pattern>
-        <pattern><![CDATA[*.yml]]></pattern>
-        <pattern><![CDATA[*.yaml]]></pattern>
-        <pattern><![CDATA[*.ini]]></pattern>
-        <pattern><![CDATA[*.dist]]></pattern>
-        <pattern><![CDATA[*.sql]]></pattern>
-        <pattern><![CDATA[*.md]]></pattern>
-        <pattern><![CDATA[*.rst]]></pattern>
-        <pattern><![CDATA[composer.*]]></pattern>
-        <pattern><![CDATA[.gitignore]]></pattern>
-        <pattern><![CDATA[LICENSE]]></pattern>
-        <pattern><![CDATA[README]]></pattern>
-        <pattern><![CDATA[Makefile]]></pattern>
-        <pattern><![CDATA[.htaccess]]></pattern>
-      </file>
-      <php>
-        <pattern><![CDATA[*.php]]></pattern>
-      </php>
-      <twig>
-        <pattern><![CDATA[*.twig]]></pattern>
-      </twig>
-    </patterns>
-    <rules>
-      <rule name="symfony.use_dir_file_constant" enabled="false"/>
-    </rules>
-    <parameters>
-      <parameter name="project_type">1</parameter>
-    </parameters>
-    <env/>
-    <notifications/>
-  </configuration>
-  <previous-analyses-references>
-    <analysis-reference number="2">991eaed501fce2475f27016ada485d827111b9b4</analysis-reference>
-    <analysis-reference number="1">61f7fa0f78cead3fca504e1bc82bb00d39b224ed</analysis-reference>
-  </previous-analyses-references>
-  <nb-violations-new>4</nb-violations-new>
-  <nb-violations-existing>0</nb-violations-existing>
-  <nb-violations-fixed>0</nb-violations-fixed>
-  <nb-violations-ignored>0</nb-violations-ignored>
-</analysis>
diff --git a/.idea/symfony2.xml b/.idea/symfony2.xml
deleted file mode 100644
index 632dba4..0000000
--- a/.idea/symfony2.xml
+++ /dev/null
@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="Symfony2PluginSettings">
-    <option name="dismissEnableNotification" value="true" />
-  </component>
-</project>
\ No newline at end of file
diff --git a/.idea/vcs.xml b/.idea/vcs.xml
deleted file mode 100644
index 94a25f7..0000000
--- a/.idea/vcs.xml
+++ /dev/null
@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="VcsDirectoryMappings">
-    <mapping directory="$PROJECT_DIR$" vcs="Git" />
-  </component>
-</project>
\ No newline at end of file
diff --git a/.idea/votifier-client-php.iml b/.idea/votifier-client-php.iml
deleted file mode 100644
index 4424864..0000000
--- a/.idea/votifier-client-php.iml
+++ /dev/null
@@ -1,76 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<module type="WEB_MODULE" version="4">
-  <component name="NewModuleRootManager">
-    <content url="file://$MODULE_DIR$">
-      <sourceFolder url="file://$MODULE_DIR$/spec" isTestSource="true" />
-      <sourceFolder url="file://$MODULE_DIR$/tests" isTestSource="true" packagePrefix="D3strukt0r\Votifier\Client\" />
-      <sourceFolder url="file://$MODULE_DIR$/src" isTestSource="false" packagePrefix="D3strukt0r\Votifier\Client\" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/composer" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/dealerdirect/phpcodesniffer-composer-installer" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/doctrine/annotations" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/doctrine/instantiator" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/doctrine/lexer" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/friendsofphp/php-cs-fixer" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/myclabs/deep-copy" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/nikic/php-parser" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/paragonie/random_compat" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phar-io/manifest" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phar-io/version" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/php-cs-fixer/diff" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phpcompatibility/php-compatibility" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phpdocumentor/reflection-common" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phpdocumentor/reflection-docblock" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phpdocumentor/type-resolver" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phpspec/prophecy" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-code-coverage" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-file-iterator" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-invoker" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-text-template" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/php-timer" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/phpunit/phpunit" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/container" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/event-dispatcher" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/psr/log" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/cli-parser" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/code-unit" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/code-unit-reverse-lookup" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/comparator" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/complexity" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/diff" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/environment" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/exporter" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/global-state" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/lines-of-code" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/object-enumerator" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/object-reflector" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/recursion-context" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/resource-operations" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/type" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/sebastian/version" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/squizlabs/php_codesniffer" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/console" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/deprecation-contracts" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/event-dispatcher" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/event-dispatcher-contracts" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/filesystem" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/finder" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/options-resolver" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-ctype" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-intl-grapheme" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-intl-normalizer" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-mbstring" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php70" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php72" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php73" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php80" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/process" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/service-contracts" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/stopwatch" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/string" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/theseer/tokenizer" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/webmozart/assert" />
-    </content>
-    <orderEntry type="inheritedJdk" />
-    <orderEntry type="sourceFolder" forTests="false" />
-  </component>
-</module>
\ No newline at end of file
diff --git a/.vscode/settings.json b/.vscode/settings.json
deleted file mode 100644
index d57c824..0000000
--- a/.vscode/settings.json
+++ /dev/null
@@ -1,6 +0,0 @@
-{
-    "restructuredtext.confPath": "${workspaceFolder}\\docs",
-    "phpcs.standard": "./.phpcs.xml",
-    "phpcs.executablePath": "./vendor/bin/phpcs",
-    "phpcs.autoConfigSearch": false,
-}
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..34dfe90
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,156 @@
+# AGENTS.md
+
+Guidance for AI agents (and humans) working in this repository.
+
+## What this is
+
+`d3strukt0r/votifier-client` (repo `Team-MaRo/votifier-client-php`) — a PHP library that
+sends vote packets to a Minecraft server running the Votifier / NuVotifier plugin.
+Published on Packagist; consumed via `composer require d3strukt0r/votifier-client`. PHP 7.1+.
+
+## Commands
+
+Everything runs through Composer scripts (see `composer.json` `scripts`):
+
+| Task | Command |
+|------|---------|
+| Install deps | `composer install` |
+| Run tests | `composer test` (→ `phpunit`) |
+| Single test file | `vendor/bin/phpunit tests/Server/VotifierTest.php` |
+| Single test method | `vendor/bin/phpunit --filter testMethodName` |
+| Lint — PHP_CodeSniffer | `composer check` (→ `phpcs`) |
+| Auto-fix — phpcbf | `composer fix` |
+| Lint — PHP-CS-Fixer (dry run + diff) | `composer cs` |
+| Auto-fix — PHP-CS-Fixer | `composer cs:fix` |
+| Static analysis — PHPStan | `composer phpstan` |
+
+**Three CI gates — a change must pass all three:**
+- **PHP_CodeSniffer** (`.phpcs.xml`): the PHP-version-compatibility gate only —
+  `PHPCompatibility` against `testVersion 7.1-`. It does **not** enforce PSR12; style is
+  owned entirely by PHP-CS-Fixer (running both just made them fight over concat spacing,
+  single-line empty bodies, etc.).
+- **PHP-CS-Fixer** (`.php-cs-fixer.dist.php`): uses the shared `iwf-web/php-coding-standard`
+  package (`@IWFWeb/standard` + `:risky` custom rule sets), stamps an MIT header onto
+  every file via `header_comment` (the header's name/years come from `LICENSE.txt`, the
+  email from `composer.json`), and overrides `trailing_comma_in_multiline` to `arrays`
+  only — trailing commas in calls (PHP 7.3+) or declarations (8.0+) would break the
+  library's PHP 7.1 support.
+- **PHPStan** (`phpstan.dist.neon`): static analysis at **level 6** over `src/` and
+  `tests/`. `phpstan/phpstan-phpunit` (auto-loaded via `phpstan/extension-installer`)
+  teaches it PHPUnit mocks. Existing findings are grandfathered in `phpstan-baseline.neon`
+  (regenerate with `vendor/bin/phpstan analyse --generate-baseline`), so only *new* issues
+  fail CI.
+
+All three (plus `composer validate`) run in the `style` job on a modern PHP; the test
+matrix (PHP 7.1-8.5) runs only PHPUnit. PHP-CS-Fixer and PHPStan require PHP 7.4+, so the
+matrix legs strip them before installing.
+
+Coverage: not configured in `phpunit.xml.dist` (the `<coverage>` element only exists in
+the PHPUnit 9.3+ schema and would break the PHPUnit 7/8 legs). CI drives it from the CLI
+on the coverage leg — `phpunit --coverage-clover coverage/logs/clover.xml --coverage-filter src`
+with Xdebug — and uploads the clover report; other legs run `--no-coverage`. Locally, add
+the same flags (with a coverage driver) if you want a report.
+
+Docker dev shell (`php:7.4-cli`, repo mounted at `/usr/src/app`):
+`docker compose build` then `docker compose run --rm php composer test` (or any command).
+`compose.yml` also defines a `spigot` service (the `d3strukt0r/spigot` image) and a
+`web` service (the `public/` test UI). `docker compose up` starts both: Spigot exposes
+Minecraft on 25565 and Votifier/NuVotifier on 8192 (server data — including a plugin you
+drop in `./server/plugins` — persists under the gitignored `./server`), and the web UI
+builds its own PHP 7.2 image (`public/Dockerfile`) and serves on 8000, reaching the plugin
+via `VOTIFIER_HOST=spigot`.
+
+## Library architecture (`src/`, namespace `D3strukt0r\Votifier\Client`)
+
+Public flow: build a **Server**, build one or more **Vote** objects, call
+`$server->sendVote($vote)`. All setters return `$this` (fluent builder); `sendVote()` is
+variadic.
+
+- **`Socket`** — thin wrapper over a raw TCP socket (`open`/`write`/`read`, auto-close in
+  destructor). Servers own a `Socket`; tests inject a mock here.
+- **`Server/`** — protocol layer.
+  - `ServerInterface` — contract: host, port, public key, `verifyConnection()`, `sendVote()`.
+  - `GenericServer` (abstract) — holds the `Socket`, host, port, public key + accessors.
+  - `Votifier extends GenericServer` — **classic** Votifier (RSA-encrypted packet to the
+    server's public key).
+  - `NuVotifier extends Votifier` — NuVotifier v1 **and** v2 (`setProtocolV2(true)` +
+    `setToken(...)` → challenge/HMAC instead of the RSA key). Reuses the classic packet path
+    and overrides `verifyConnection`/`sendVote`/`preparePackage*`.
+- **`Vote/`** — `VoteInterface` + `ClassicVote` (payload: username, service name, address,
+  timestamp), also a fluent builder.
+- **`Exception/`** — typed exceptions the caller catches: protocol-level at the root
+  (`NotVotifierException`, the `NuVotifier*` family) and transport-level under
+  `Exception/Socket/`. Setters throw `\InvalidArgumentException` when a required field is
+  unset before a send. The README usage block is the canonical catch list.
+
+## Tests (`tests/`)
+
+- PSR-4 mapped to the **same** namespace root as the library (`autoload-dev`), mirroring `src/`.
+- `tests/Server/votifier_private.key` / `votifier_public.key` are RSA fixtures exercising
+  the encryption end to end — keep them in sync if the crypto changes.
+- Stub properties are typed with the **intersection** `@var Foo&Stub` (e.g. `Socket&Stub`),
+  not a union — PHPStan then resolves both the stubbed methods (`->method()`, from `Stub`)
+  and the real class's methods, instead of flagging `method.notFound`.
+
+## `public/` — end-to-end test server (develop only)
+
+Standalone PHP app (`App\` namespace) that drives the library against a real server via
+Symfony **5.4** components (so it runs on PHP 7.2.5+, matching its `php:7.2` image). It is
+its **own composer island** (`public/composer.json`, path-requiring the library) so its
+web-framework dependencies stay out of the published package; its lock is resolved inside
+the container (no `config.platform.php`). Two ways to run it:
+`docker compose up` (the `web` service builds `public/Dockerfile` and serves on 8000,
+talking to the `spigot` service), or `bash public/start.sh` on the host (serves
+`localhost:8000`, installs `public/vendor` on first run). `start.sh` honours `LISTEN`
+(bind address, default `localhost:8000`) and the controllers honour `VOTIFIER_HOST`
+(default `127.0.0.1`).
+
+To exercise it, install a Votifier plugin into `server/plugins/` (use **NuVotifier** — the
+classic vexsoftware Votifier only runs on Java 8, i.e. Minecraft ≤ 1.16.5; see
+`docs/source/getting-started/votifier.rst` for links and the why). On first start the
+plugin generates `server/plugins/Votifier/rsa/public.key` (classic RSA flow) and
+`config.yml` with `tokens.default` (NuVotifier v2 flow) — the exact paths the controllers
+read. The client encrypts with `openssl_public_encrypt`'s default PKCS#1 v1.5 padding,
+which is what Votifier decrypts with (it uses `Cipher.getInstance("RSA")`, resolved by the
+JDK's SunJCE provider to PKCS#1 v1.5).
+
+For feedback that a vote was received: NuVotifier logs every vote to the console by
+default; classic Votifier needs a listener — `tools/votifier-listener/` has one
+(`bash tools/votifier-listener/build.sh` compiles it against the Votifier jar in a Java 8
+container and drops the `.class` into `server/plugins/Votifier/listeners/`; restart spigot
+to load it). It fires only after a vote successfully decrypts, so it doubles as proof the
+server accepted the packet (a `BadPaddingException` instead means the client's public key
+doesn't match the server's current keypair — recopy `rsa/public.key`). If the client can't
+connect at all ("could not create a connection" / "couldn't be received") yet the plugin is
+listed in `/plugins`, it failed to **enable** — check the server log (classic Votifier on a
+modern JDK fails with the JAXB `NoClassDefFoundError` noted above).
+
+## Documentation (`docs/`, Sphinx → Read the Docs)
+
+- Build locally: `cd docs && make html` (needs `docs/requirements.txt`). Config in
+  `docs/source/conf.py`; `copyright`/`author` are derived from `LICENSE.txt` at build time.
+- **Community-health files are a git submodule:** `docs/source/_community` → `Team-MaRo/.github`.
+  Code of Conduct / Contributing are pulled from there (not duplicated). After cloning run
+  `git submodule update --init`; edit those documents in the central repo, not here.
+- **The CC license page is generated, not committed:** `docs/update-license.py` converts
+  the official CC BY-NC-SA 4.0 legalcode to reStructuredText `docs/LICENSE.rst` (gitignored)
+  — native lettered/roman lists, underlined defined terms (`:underline:` role, styled by
+  `_static/css/custom.css`), bold, links. It fetches the official HTML, **falling back** to
+  the committed plain-text `docs/LICENSE.txt` if offline (fallback drops underline/bold).
+  RTD runs it in a `build.jobs.pre_build` step; locally run `uv run docs/update-license.py`
+  before `make html`.
+
+## Licensing
+
+Two separate licenses: the **code** is MIT (root `LICENSE.txt`), the **documentation** is
+CC BY-NC-SA 4.0 (`docs/LICENSE.txt` + the generated `docs/LICENSE.md`).
+
+## Conventions
+
+- **Branching:** git-flow. `master` = stable/released, `develop` = nightly.
+- **Releases:** release-please (`.github/release-please-config.json` + manifest) cuts
+  `chore(master): release X.Y.Z` commits and tags from Conventional-Commit history.
+- **Commits:** Conventional Commits; commits are GPG-signed by the maintainer.
+- **Code ownership / CI:** `.github/CODEOWNERS` (`@Team-MaRo/CI`), Dependabot
+  (`composer`, `github-actions`, `docker`) with auto-merge/validate workflows, and a
+  `labeler` workflow. The published archive excludes dev/tooling files (`archive.exclude`).
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
deleted file mode 100644
index dedec18..0000000
--- a/CONTRIBUTING.md
+++ /dev/null
@@ -1,59 +0,0 @@
-# Contributing
-
-When contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with the owners of this repository before making a change.
-
-Please note we have a code of conduct, please follow it in all your interactions with the project.
-
-## Pull Request Process
-
-1.  Ensure any install or build dependencies are removed before the end of the layer when doing a build.
-2.  Update the README.md with details of changes to the interface, this includes new environment variables, exposed ports, useful file locations and container parameters.
-3.  Increase the version numbers in any examples files and the README.md to the new version that this Pull Request would represent. The versioning scheme we use is [SemVer](http://semver.org/).
-4.  You may merge the Pull Request in once you have the sign-off of two other developers, or if you do not have permission to do that, you may request the second reviewer to merge it for you.
-
-## Code of Conduct
-
-### Our Pledge
-
-In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
-
-### Our Standards
-
-Examples of behavior that contributes to creating a positive environment include:
-
--   Using welcoming and inclusive language
--   Being respectful of differing viewpoints and experiences
--   Gracefully accepting constructive criticism
--   Focusing on what is best for the community
--   Showing empathy towards other community members
-
-Examples of unacceptable behavior by participants include:
-
--   The use of sexualized language or imagery and unwelcome sexual attention or advances
--   Trolling, insulting/derogatory comments, and personal or political attacks
--   Public or private harassment
--   Publishing others' private information, such as a physical or electronic address, without explicit permission
--   Other conduct which could reasonably be considered inappropriate in a professional setting
-
-### Our Responsibilities
-
-Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
-
-Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
-
-### Scope
-
-This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
-
-### Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at [manuele.vaccari@gmail.com](mailto:manuele.vaccari@gmail.com). All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
-
-Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
-
-### Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
-
-[homepage]: http://contributor-covenant.org
-[version]: http://contributor-covenant.org/version/1/4/
diff --git a/LICENSE.txt b/LICENSE.txt
index f288702..73f9338 100644
--- a/LICENSE.txt
+++ b/LICENSE.txt
@@ -1,674 +1,21 @@
-                    GNU GENERAL PUBLIC LICENSE
-                       Version 3, 29 June 2007
-
- Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
-
-                            Preamble
-
-  The GNU General Public License is a free, copyleft license for
-software and other kinds of works.
-
-  The licenses for most software and other practical works are designed
-to take away your freedom to share and change the works.  By contrast,
-the GNU General Public License is intended to guarantee your freedom to
-share and change all versions of a program--to make sure it remains free
-software for all its users.  We, the Free Software Foundation, use the
-GNU General Public License for most of our software; it applies also to
-any other work released this way by its authors.  You can apply it to
-your programs, too.
-
-  When we speak of free software, we are referring to freedom, not
-price.  Our General Public Licenses are designed to make sure that you
-have the freedom to distribute copies of free software (and charge for
-them if you wish), that you receive source code or can get it if you
-want it, that you can change the software or use pieces of it in new
-free programs, and that you know you can do these things.
-
-  To protect your rights, we need to prevent others from denying you
-these rights or asking you to surrender the rights.  Therefore, you have
-certain responsibilities if you distribute copies of the software, or if
-you modify it: responsibilities to respect the freedom of others.
-
-  For example, if you distribute copies of such a program, whether
-gratis or for a fee, you must pass on to the recipients the same
-freedoms that you received.  You must make sure that they, too, receive
-or can get the source code.  And you must show them these terms so they
-know their rights.
-
-  Developers that use the GNU GPL protect your rights with two steps:
-(1) assert copyright on the software, and (2) offer you this License
-giving you legal permission to copy, distribute and/or modify it.
-
-  For the developers' and authors' protection, the GPL clearly explains
-that there is no warranty for this free software.  For both users' and
-authors' sake, the GPL requires that modified versions be marked as
-changed, so that their problems will not be attributed erroneously to
-authors of previous versions.
-
-  Some devices are designed to deny users access to install or run
-modified versions of the software inside them, although the manufacturer
-can do so.  This is fundamentally incompatible with the aim of
-protecting users' freedom to change the software.  The systematic
-pattern of such abuse occurs in the area of products for individuals to
-use, which is precisely where it is most unacceptable.  Therefore, we
-have designed this version of the GPL to prohibit the practice for those
-products.  If such problems arise substantially in other domains, we
-stand ready to extend this provision to those domains in future versions
-of the GPL, as needed to protect the freedom of users.
-
-  Finally, every program is threatened constantly by software patents.
-States should not allow patents to restrict development and use of
-software on general-purpose computers, but in those that do, we wish to
-avoid the special danger that patents applied to a free program could
-make it effectively proprietary.  To prevent this, the GPL assures that
-patents cannot be used to render the program non-free.
-
-  The precise terms and conditions for copying, distribution and
-modification follow.
-
-                       TERMS AND CONDITIONS
-
-  0. Definitions.
-
-  "This License" refers to version 3 of the GNU General Public License.
-
-  "Copyright" also means copyright-like laws that apply to other kinds of
-works, such as semiconductor masks.
-
-  "The Program" refers to any copyrightable work licensed under this
-License.  Each licensee is addressed as "you".  "Licensees" and
-"recipients" may be individuals or organizations.
-
-  To "modify" a work means to copy from or adapt all or part of the work
-in a fashion requiring copyright permission, other than the making of an
-exact copy.  The resulting work is called a "modified version" of the
-earlier work or a work "based on" the earlier work.
-
-  A "covered work" means either the unmodified Program or a work based
-on the Program.
-
-  To "propagate" a work means to do anything with it that, without
-permission, would make you directly or secondarily liable for
-infringement under applicable copyright law, except executing it on a
-computer or modifying a private copy.  Propagation includes copying,
-distribution (with or without modification), making available to the
-public, and in some countries other activities as well.
-
-  To "convey" a work means any kind of propagation that enables other
-parties to make or receive copies.  Mere interaction with a user through
-a computer network, with no transfer of a copy, is not conveying.
-
-  An interactive user interface displays "Appropriate Legal Notices"
-to the extent that it includes a convenient and prominently visible
-feature that (1) displays an appropriate copyright notice, and (2)
-tells the user that there is no warranty for the work (except to the
-extent that warranties are provided), that licensees may convey the
-work under this License, and how to view a copy of this License.  If
-the interface presents a list of user commands or options, such as a
-menu, a prominent item in the list meets this criterion.
-
-  1. Source Code.
-
-  The "source code" for a work means the preferred form of the work
-for making modifications to it.  "Object code" means any non-source
-form of a work.
-
-  A "Standard Interface" means an interface that either is an official
-standard defined by a recognized standards body, or, in the case of
-interfaces specified for a particular programming language, one that
-is widely used among developers working in that language.
-
-  The "System Libraries" of an executable work include anything, other
-than the work as a whole, that (a) is included in the normal form of
-packaging a Major Component, but which is not part of that Major
-Component, and (b) serves only to enable use of the work with that
-Major Component, or to implement a Standard Interface for which an
-implementation is available to the public in source code form.  A
-"Major Component", in this context, means a major essential component
-(kernel, window system, and so on) of the specific operating system
-(if any) on which the executable work runs, or a compiler used to
-produce the work, or an object code interpreter used to run it.
-
-  The "Corresponding Source" for a work in object code form means all
-the source code needed to generate, install, and (for an executable
-work) run the object code and to modify the work, including scripts to
-control those activities.  However, it does not include the work's
-System Libraries, or general-purpose tools or generally available free
-programs which are used unmodified in performing those activities but
-which are not part of the work.  For example, Corresponding Source
-includes interface definition files associated with source files for
-the work, and the source code for shared libraries and dynamically
-linked subprograms that the work is specifically designed to require,
-such as by intimate data communication or control flow between those
-subprograms and other parts of the work.
-
-  The Corresponding Source need not include anything that users
-can regenerate automatically from other parts of the Corresponding
-Source.
-
-  The Corresponding Source for a work in source code form is that
-same work.
-
-  2. Basic Permissions.
-
-  All rights granted under this License are granted for the term of
-copyright on the Program, and are irrevocable provided the stated
-conditions are met.  This License explicitly affirms your unlimited
-permission to run the unmodified Program.  The output from running a
-covered work is covered by this License only if the output, given its
-content, constitutes a covered work.  This License acknowledges your
-rights of fair use or other equivalent, as provided by copyright law.
-
-  You may make, run and propagate covered works that you do not
-convey, without conditions so long as your license otherwise remains
-in force.  You may convey covered works to others for the sole purpose
-of having them make modifications exclusively for you, or provide you
-with facilities for running those works, provided that you comply with
-the terms of this License in conveying all material for which you do
-not control copyright.  Those thus making or running the covered works
-for you must do so exclusively on your behalf, under your direction
-and control, on terms that prohibit them from making any copies of
-your copyrighted material outside their relationship with you.
-
-  Conveying under any other circumstances is permitted solely under
-the conditions stated below.  Sublicensing is not allowed; section 10
-makes it unnecessary.
-
-  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
-
-  No covered work shall be deemed part of an effective technological
-measure under any applicable law fulfilling obligations under article
-11 of the WIPO copyright treaty adopted on 20 December 1996, or
-similar laws prohibiting or restricting circumvention of such
-measures.
-
-  When you convey a covered work, you waive any legal power to forbid
-circumvention of technological measures to the extent such circumvention
-is effected by exercising rights under this License with respect to
-the covered work, and you disclaim any intention to limit operation or
-modification of the work as a means of enforcing, against the work's
-users, your or third parties' legal rights to forbid circumvention of
-technological measures.
-
-  4. Conveying Verbatim Copies.
-
-  You may convey verbatim copies of the Program's source code as you
-receive it, in any medium, provided that you conspicuously and
-appropriately publish on each copy an appropriate copyright notice;
-keep intact all notices stating that this License and any
-non-permissive terms added in accord with section 7 apply to the code;
-keep intact all notices of the absence of any warranty; and give all
-recipients a copy of this License along with the Program.
-
-  You may charge any price or no price for each copy that you convey,
-and you may offer support or warranty protection for a fee.
-
-  5. Conveying Modified Source Versions.
-
-  You may convey a work based on the Program, or the modifications to
-produce it from the Program, in the form of source code under the
-terms of section 4, provided that you also meet all of these conditions:
-
-    a) The work must carry prominent notices stating that you modified
-    it, and giving a relevant date.
-
-    b) The work must carry prominent notices stating that it is
-    released under this License and any conditions added under section
-    7.  This requirement modifies the requirement in section 4 to
-    "keep intact all notices".
-
-    c) You must license the entire work, as a whole, under this
-    License to anyone who comes into possession of a copy.  This
-    License will therefore apply, along with any applicable section 7
-    additional terms, to the whole of the work, and all its parts,
-    regardless of how they are packaged.  This License gives no
-    permission to license the work in any other way, but it does not
-    invalidate such permission if you have separately received it.
-
-    d) If the work has interactive user interfaces, each must display
-    Appropriate Legal Notices; however, if the Program has interactive
-    interfaces that do not display Appropriate Legal Notices, your
-    work need not make them do so.
-
-  A compilation of a covered work with other separate and independent
-works, which are not by their nature extensions of the covered work,
-and which are not combined with it such as to form a larger program,
-in or on a volume of a storage or distribution medium, is called an
-"aggregate" if the compilation and its resulting copyright are not
-used to limit the access or legal rights of the compilation's users
-beyond what the individual works permit.  Inclusion of a covered work
-in an aggregate does not cause this License to apply to the other
-parts of the aggregate.
-
-  6. Conveying Non-Source Forms.
-
-  You may convey a covered work in object code form under the terms
-of sections 4 and 5, provided that you also convey the
-machine-readable Corresponding Source under the terms of this License,
-in one of these ways:
-
-    a) Convey the object code in, or embodied in, a physical product
-    (including a physical distribution medium), accompanied by the
-    Corresponding Source fixed on a durable physical medium
-    customarily used for software interchange.
-
-    b) Convey the object code in, or embodied in, a physical product
-    (including a physical distribution medium), accompanied by a
-    written offer, valid for at least three years and valid for as
-    long as you offer spare parts or customer support for that product
-    model, to give anyone who possesses the object code either (1) a
-    copy of the Corresponding Source for all the software in the
-    product that is covered by this License, on a durable physical
-    medium customarily used for software interchange, for a price no
-    more than your reasonable cost of physically performing this
-    conveying of source, or (2) access to copy the
-    Corresponding Source from a network server at no charge.
-
-    c) Convey individual copies of the object code with a copy of the
-    written offer to provide the Corresponding Source.  This
-    alternative is allowed only occasionally and noncommercially, and
-    only if you received the object code with such an offer, in accord
-    with subsection 6b.
-
-    d) Convey the object code by offering access from a designated
-    place (gratis or for a charge), and offer equivalent access to the
-    Corresponding Source in the same way through the same place at no
-    further charge.  You need not require recipients to copy the
-    Corresponding Source along with the object code.  If the place to
-    copy the object code is a network server, the Corresponding Source
-    may be on a different server (operated by you or a third party)
-    that supports equivalent copying facilities, provided you maintain
-    clear directions next to the object code saying where to find the
-    Corresponding Source.  Regardless of what server hosts the
-    Corresponding Source, you remain obligated to ensure that it is
-    available for as long as needed to satisfy these requirements.
-
-    e) Convey the object code using peer-to-peer transmission, provided
-    you inform other peers where the object code and Corresponding
-    Source of the work are being offered to the general public at no
-    charge under subsection 6d.
-
-  A separable portion of the object code, whose source code is excluded
-from the Corresponding Source as a System Library, need not be
-included in conveying the object code work.
-
-  A "User Product" is either (1) a "consumer product", which means any
-tangible personal property which is normally used for personal, family,
-or household purposes, or (2) anything designed or sold for incorporation
-into a dwelling.  In determining whether a product is a consumer product,
-doubtful cases shall be resolved in favor of coverage.  For a particular
-product received by a particular user, "normally used" refers to a
-typical or common use of that class of product, regardless of the status
-of the particular user or of the way in which the particular user
-actually uses, or expects or is expected to use, the product.  A product
-is a consumer product regardless of whether the product has substantial
-commercial, industrial or non-consumer uses, unless such uses represent
-the only significant mode of use of the product.
-
-  "Installation Information" for a User Product means any methods,
-procedures, authorization keys, or other information required to install
-and execute modified versions of a covered work in that User Product from
-a modified version of its Corresponding Source.  The information must
-suffice to ensure that the continued functioning of the modified object
-code is in no case prevented or interfered with solely because
-modification has been made.
-
-  If you convey an object code work under this section in, or with, or
-specifically for use in, a User Product, and the conveying occurs as
-part of a transaction in which the right of possession and use of the
-User Product is transferred to the recipient in perpetuity or for a
-fixed term (regardless of how the transaction is characterized), the
-Corresponding Source conveyed under this section must be accompanied
-by the Installation Information.  But this requirement does not apply
-if neither you nor any third party retains the ability to install
-modified object code on the User Product (for example, the work has
-been installed in ROM).
-
-  The requirement to provide Installation Information does not include a
-requirement to continue to provide support service, warranty, or updates
-for a work that has been modified or installed by the recipient, or for
-the User Product in which it has been modified or installed.  Access to a
-network may be denied when the modification itself materially and
-adversely affects the operation of the network or violates the rules and
-protocols for communication across the network.
-
-  Corresponding Source conveyed, and Installation Information provided,
-in accord with this section must be in a format that is publicly
-documented (and with an implementation available to the public in
-source code form), and must require no special password or key for
-unpacking, reading or copying.
-
-  7. Additional Terms.
-
-  "Additional permissions" are terms that supplement the terms of this
-License by making exceptions from one or more of its conditions.
-Additional permissions that are applicable to the entire Program shall
-be treated as though they were included in this License, to the extent
-that they are valid under applicable law.  If additional permissions
-apply only to part of the Program, that part may be used separately
-under those permissions, but the entire Program remains governed by
-this License without regard to the additional permissions.
-
-  When you convey a copy of a covered work, you may at your option
-remove any additional permissions from that copy, or from any part of
-it.  (Additional permissions may be written to require their own
-removal in certain cases when you modify the work.)  You may place
-additional permissions on material, added by you to a covered work,
-for which you have or can give appropriate copyright permission.
-
-  Notwithstanding any other provision of this License, for material you
-add to a covered work, you may (if authorized by the copyright holders of
-that material) supplement the terms of this License with terms:
-
-    a) Disclaiming warranty or limiting liability differently from the
-    terms of sections 15 and 16 of this License; or
-
-    b) Requiring preservation of specified reasonable legal notices or
-    author attributions in that material or in the Appropriate Legal
-    Notices displayed by works containing it; or
-
-    c) Prohibiting misrepresentation of the origin of that material, or
-    requiring that modified versions of such material be marked in
-    reasonable ways as different from the original version; or
-
-    d) Limiting the use for publicity purposes of names of licensors or
-    authors of the material; or
-
-    e) Declining to grant rights under trademark law for use of some
-    trade names, trademarks, or service marks; or
-
-    f) Requiring indemnification of licensors and authors of that
-    material by anyone who conveys the material (or modified versions of
-    it) with contractual assumptions of liability to the recipient, for
-    any liability that these contractual assumptions directly impose on
-    those licensors and authors.
-
-  All other non-permissive additional terms are considered "further
-restrictions" within the meaning of section 10.  If the Program as you
-received it, or any part of it, contains a notice stating that it is
-governed by this License along with a term that is a further
-restriction, you may remove that term.  If a license document contains
-a further restriction but permits relicensing or conveying under this
-License, you may add to a covered work material governed by the terms
-of that license document, provided that the further restriction does
-not survive such relicensing or conveying.
-
-  If you add terms to a covered work in accord with this section, you
-must place, in the relevant source files, a statement of the
-additional terms that apply to those files, or a notice indicating
-where to find the applicable terms.
-
-  Additional terms, permissive or non-permissive, may be stated in the
-form of a separately written license, or stated as exceptions;
-the above requirements apply either way.
-
-  8. Termination.
-
-  You may not propagate or modify a covered work except as expressly
-provided under this License.  Any attempt otherwise to propagate or
-modify it is void, and will automatically terminate your rights under
-this License (including any patent licenses granted under the third
-paragraph of section 11).
-
-  However, if you cease all violation of this License, then your
-license from a particular copyright holder is reinstated (a)
-provisionally, unless and until the copyright holder explicitly and
-finally terminates your license, and (b) permanently, if the copyright
-holder fails to notify you of the violation by some reasonable means
-prior to 60 days after the cessation.
-
-  Moreover, your license from a particular copyright holder is
-reinstated permanently if the copyright holder notifies you of the
-violation by some reasonable means, this is the first time you have
-received notice of violation of this License (for any work) from that
-copyright holder, and you cure the violation prior to 30 days after
-your receipt of the notice.
-
-  Termination of your rights under this section does not terminate the
-licenses of parties who have received copies or rights from you under
-this License.  If your rights have been terminated and not permanently
-reinstated, you do not qualify to receive new licenses for the same
-material under section 10.
-
-  9. Acceptance Not Required for Having Copies.
-
-  You are not required to accept this License in order to receive or
-run a copy of the Program.  Ancillary propagation of a covered work
-occurring solely as a consequence of using peer-to-peer transmission
-to receive a copy likewise does not require acceptance.  However,
-nothing other than this License grants you permission to propagate or
-modify any covered work.  These actions infringe copyright if you do
-not accept this License.  Therefore, by modifying or propagating a
-covered work, you indicate your acceptance of this License to do so.
-
-  10. Automatic Licensing of Downstream Recipients.
-
-  Each time you convey a covered work, the recipient automatically
-receives a license from the original licensors, to run, modify and
-propagate that work, subject to this License.  You are not responsible
-for enforcing compliance by third parties with this License.
-
-  An "entity transaction" is a transaction transferring control of an
-organization, or substantially all assets of one, or subdividing an
-organization, or merging organizations.  If propagation of a covered
-work results from an entity transaction, each party to that
-transaction who receives a copy of the work also receives whatever
-licenses to the work the party's predecessor in interest had or could
-give under the previous paragraph, plus a right to possession of the
-Corresponding Source of the work from the predecessor in interest, if
-the predecessor has it or can get it with reasonable efforts.
-
-  You may not impose any further restrictions on the exercise of the
-rights granted or affirmed under this License.  For example, you may
-not impose a license fee, royalty, or other charge for exercise of
-rights granted under this License, and you may not initiate litigation
-(including a cross-claim or counterclaim in a lawsuit) alleging that
-any patent claim is infringed by making, using, selling, offering for
-sale, or importing the Program or any portion of it.
-
-  11. Patents.
-
-  A "contributor" is a copyright holder who authorizes use under this
-License of the Program or a work on which the Program is based.  The
-work thus licensed is called the contributor's "contributor version".
-
-  A contributor's "essential patent claims" are all patent claims
-owned or controlled by the contributor, whether already acquired or
-hereafter acquired, that would be infringed by some manner, permitted
-by this License, of making, using, or selling its contributor version,
-but do not include claims that would be infringed only as a
-consequence of further modification of the contributor version.  For
-purposes of this definition, "control" includes the right to grant
-patent sublicenses in a manner consistent with the requirements of
-this License.
-
-  Each contributor grants you a non-exclusive, worldwide, royalty-free
-patent license under the contributor's essential patent claims, to
-make, use, sell, offer for sale, import and otherwise run, modify and
-propagate the contents of its contributor version.
-
-  In the following three paragraphs, a "patent license" is any express
-agreement or commitment, however denominated, not to enforce a patent
-(such as an express permission to practice a patent or covenant not to
-sue for patent infringement).  To "grant" such a patent license to a
-party means to make such an agreement or commitment not to enforce a
-patent against the party.
-
-  If you convey a covered work, knowingly relying on a patent license,
-and the Corresponding Source of the work is not available for anyone
-to copy, free of charge and under the terms of this License, through a
-publicly available network server or other readily accessible means,
-then you must either (1) cause the Corresponding Source to be so
-available, or (2) arrange to deprive yourself of the benefit of the
-patent license for this particular work, or (3) arrange, in a manner
-consistent with the requirements of this License, to extend the patent
-license to downstream recipients.  "Knowingly relying" means you have
-actual knowledge that, but for the patent license, your conveying the
-covered work in a country, or your recipient's use of the covered work
-in a country, would infringe one or more identifiable patents in that
-country that you have reason to believe are valid.
-
-  If, pursuant to or in connection with a single transaction or
-arrangement, you convey, or propagate by procuring conveyance of, a
-covered work, and grant a patent license to some of the parties
-receiving the covered work authorizing them to use, propagate, modify
-or convey a specific copy of the covered work, then the patent license
-you grant is automatically extended to all recipients of the covered
-work and works based on it.
-
-  A patent license is "discriminatory" if it does not include within
-the scope of its coverage, prohibits the exercise of, or is
-conditioned on the non-exercise of one or more of the rights that are
-specifically granted under this License.  You may not convey a covered
-work if you are a party to an arrangement with a third party that is
-in the business of distributing software, under which you make payment
-to the third party based on the extent of your activity of conveying
-the work, and under which the third party grants, to any of the
-parties who would receive the covered work from you, a discriminatory
-patent license (a) in connection with copies of the covered work
-conveyed by you (or copies made from those copies), or (b) primarily
-for and in connection with specific products or compilations that
-contain the covered work, unless you entered into that arrangement,
-or that patent license was granted, prior to 28 March 2007.
-
-  Nothing in this License shall be construed as excluding or limiting
-any implied license or other defenses to infringement that may
-otherwise be available to you under applicable patent law.
-
-  12. No Surrender of Others' Freedom.
-
-  If conditions are imposed on you (whether by court order, agreement or
-otherwise) that contradict the conditions of this License, they do not
-excuse you from the conditions of this License.  If you cannot convey a
-covered work so as to satisfy simultaneously your obligations under this
-License and any other pertinent obligations, then as a consequence you may
-not convey it at all.  For example, if you agree to terms that obligate you
-to collect a royalty for further conveying from those to whom you convey
-the Program, the only way you could satisfy both those terms and this
-License would be to refrain entirely from conveying the Program.
-
-  13. Use with the GNU Affero General Public License.
-
-  Notwithstanding any other provision of this License, you have
-permission to link or combine any covered work with a work licensed
-under version 3 of the GNU Affero General Public License into a single
-combined work, and to convey the resulting work.  The terms of this
-License will continue to apply to the part which is the covered work,
-but the special requirements of the GNU Affero General Public License,
-section 13, concerning interaction through a network will apply to the
-combination as such.
-
-  14. Revised Versions of this License.
-
-  The Free Software Foundation may publish revised and/or new versions of
-the GNU General Public License from time to time.  Such new versions will
-be similar in spirit to the present version, but may differ in detail to
-address new problems or concerns.
-
-  Each version is given a distinguishing version number.  If the
-Program specifies that a certain numbered version of the GNU General
-Public License "or any later version" applies to it, you have the
-option of following the terms and conditions either of that numbered
-version or of any later version published by the Free Software
-Foundation.  If the Program does not specify a version number of the
-GNU General Public License, you may choose any version ever published
-by the Free Software Foundation.
-
-  If the Program specifies that a proxy can decide which future
-versions of the GNU General Public License can be used, that proxy's
-public statement of acceptance of a version permanently authorizes you
-to choose that version for the Program.
-
-  Later license versions may give you additional or different
-permissions.  However, no additional obligations are imposed on any
-author or copyright holder as a result of your choosing to follow a
-later version.
-
-  15. Disclaimer of Warranty.
-
-  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
-APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
-HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
-OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
-THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
-IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
-ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
-
-  16. Limitation of Liability.
-
-  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
-WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
-THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
-GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
-USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
-DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
-PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
-EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
-SUCH DAMAGES.
-
-  17. Interpretation of Sections 15 and 16.
-
-  If the disclaimer of warranty and limitation of liability provided
-above cannot be given local legal effect according to their terms,
-reviewing courts shall apply local law that most closely approximates
-an absolute waiver of all civil liability in connection with the
-Program, unless a warranty or assumption of liability accompanies a
-copy of the Program in return for a fee.
-
-                     END OF TERMS AND CONDITIONS
-
-            How to Apply These Terms to Your New Programs
-
-  If you develop a new program, and you want it to be of the greatest
-possible use to the public, the best way to achieve this is to make it
-free software which everyone can redistribute and change under these terms.
-
-  To do so, attach the following notices to the program.  It is safest
-to attach them to the start of each source file to most effectively
-state the exclusion of warranty; and each file should have at least
-the "copyright" line and a pointer to where the full notice is found.
-
-    <one line to give the program's name and a brief idea of what it does.>
-    Copyright (C) <year>  <name of author>
-
-    This program is free software: you can redistribute it and/or modify
-    it under the terms of the GNU General Public License as published by
-    the Free Software Foundation, either version 3 of the License, or
-    (at your option) any later version.
-
-    This program is distributed in the hope that it will be useful,
-    but WITHOUT ANY WARRANTY; without even the implied warranty of
-    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-    GNU General Public License for more details.
-
-    You should have received a copy of the GNU General Public License
-    along with this program.  If not, see <https://www.gnu.org/licenses/>.
-
-Also add information on how to contact you by electronic and paper mail.
-
-  If the program does terminal interaction, make it output a short
-notice like this when it starts in an interactive mode:
-
-    <program>  Copyright (C) <year>  <name of author>
-    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
-    This is free software, and you are welcome to redistribute it
-    under certain conditions; type `show c' for details.
-
-The hypothetical commands `show w' and `show c' should show the appropriate
-parts of the General Public License.  Of course, your program's commands
-might be different; for a GUI interface, you would use an "about box".
-
-  You should also get your employer (if you work as a programmer) or school,
-if any, to sign a "copyright disclaimer" for the program, if necessary.
-For more information on this, and how to apply and follow the GNU GPL, see
-<https://www.gnu.org/licenses/>.
-
-  The GNU General Public License does not permit incorporating your program
-into proprietary programs.  If your program is a subroutine library, you
-may consider it more useful to permit linking proprietary applications with
-the library.  If this is what you want to do, use the GNU Lesser General
-Public License instead of this License.  But first, please read
-<https://www.gnu.org/licenses/why-not-lgpl.html>.
+MIT License
+
+Copyright (c) 2015-2020, 2026 Manuele Vaccari
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/README.md b/README.md
index 9455795..7101d5b 100644
--- a/README.md
+++ b/README.md
@@ -2,32 +2,20 @@
 
 This php script allows easy using of the Bukkit plugin Votifier
 
-Project
-
-[![License](https://img.shields.io/github/license/D3strukt0r/votifier-client-php)][license]
+[![License](https://img.shields.io/github/license/Team-MaRo/votifier-client-php)](LICENSE.txt)
+[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.0-4baaaa)][code-of-conduct]
 [![Version](https://img.shields.io/packagist/v/d3strukt0r/votifier-client?label=latest%20release)][packagist]
 [![Version (including pre-releases)](https://img.shields.io/packagist/v/D3strukt0r/votifier-client?include_prereleases&label=latest%20pre-release)][packagist]
 [![Downloads on Packagist](https://img.shields.io/packagist/dt/d3strukt0r/votifier-client)][packagist]
 [![Required PHP version](https://img.shields.io/packagist/php-v/d3strukt0r/votifier-client)][packagist]
 
-master-branch (alias stable, latest)
-
-[![GH Action CI/CD](https://github.com/D3strukt0r/votifier-client-php/workflows/CI/CD/badge.svg?branch=master)][gh-action]
+[![GH Action CI](https://github.com/Team-MaRo/votifier-client-php/actions/workflows/ci.yml/badge.svg)][gh-action]
 [![Coveralls](https://img.shields.io/coveralls/github/D3strukt0r/votifier-client-php/master)][coveralls]
 [![Scrutinizer build status](https://img.shields.io/scrutinizer/build/g/D3strukt0r/votifier-client-php/master?label=scrutinizer%20build)][scrutinizer]
 [![Scrutinizer code quality](https://img.shields.io/scrutinizer/quality/g/D3strukt0r/votifier-client-php/master?label=scrutinizer%20code%20quality)][scrutinizer]
 [![Codacy grade](https://img.shields.io/codacy/grade/d97c7e16f5d24924b39f9776eeb02259/master?label=codacy%20code%20quality)][codacy]
 [![Docs build status](https://img.shields.io/readthedocs/votifier-client-php/stable)][rtfd]
 
-develop-branch (alias nightly)
-
-[![GH Action CI/CD](https://github.com/D3strukt0r/votifier-client-php/workflows/CI/CD/badge.svg?branch=develop)][gh-action]
-[![Coveralls](https://img.shields.io/coveralls/github/D3strukt0r/votifier-client-php/develop)][coveralls]
-[![Scrutinizer build status](https://img.shields.io/scrutinizer/build/g/D3strukt0r/votifier-client-php/develop?label=scrutinizer%20build)][scrutinizer]
-[![Scrutinizer code quality](https://img.shields.io/scrutinizer/quality/g/D3strukt0r/votifier-client-php/develop?label=scrutinizer%20code%20quality)][scrutinizer]
-[![Codacy grade](https://img.shields.io/codacy/grade/d97c7e16f5d24924b39f9776eeb02259/develop?label=codacy%20code%20quality)][codacy]
-[![Docs build status](https://img.shields.io/readthedocs/votifier-client-php/latest)][rtfd]
-
 ## Getting Started
 
 These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
@@ -38,8 +26,14 @@ The full documentation can be found [here](https://votifier-client-php.readthedo
 
 What things you need to install the software and how to install them
 
--   PHP Project (PHP 7.1+)
--   Minecraft server with the Votifier plugin
+- PHP Project (PHP 7.1+)
+- Minecraft server with a Votifier plugin. **NuVotifier** is recommended — the
+  classic Votifier plugin relies on `javax.xml.bind.DatatypeConverter`, which was
+  removed from the JDK in Java 11, so it only runs on Java 8 and therefore only on
+  Minecraft up to 1.16.5 (the last version that runs on Java 8; 1.17+ require Java
+  16+). On newer servers it fails to enable with `NoClassDefFoundError:
+  javax/xml/bind/DatatypeConverter`. NuVotifier runs on current Java and is
+  backwards compatible with the classic protocol.
 
 ### Installing
 
@@ -203,46 +197,63 @@ make html
 You can also create a documentation with [phpDocumentor](https://github.com/phpDocumentor/phpDocumentor). For that please downloaded at least v3+ for to work from [here](https://github.com/phpDocumentor/phpDocumentor/releases). And then you can just run it
 
 ```shell
-curl -fsSL -o /usr/local/bin/phpdoc https://github.com/phpDocumentor/phpDocumentor/releases/download/v3.0.0-rc/phpDocumentor.phar
+curl -fsSL -o /usr/local/bin/phpdoc https://github.com/phpDocumentor/phpDocumentor/releases/latest/download/phpDocumentor.phar
 phpdoc
 ```
 
 ## Built With
 
--   [PHP](https://www.php.net) - Programming Language
--   [Composer](https://getcomposer.org) - Dependency Management
--   [PHPUnit](https://phpunit.de) - Testing the code
--   [Github Actions](https://github.com/features/actions) - Automatic CI (Testing)
--   [Read the docs](https://readthedocs.org) - Documentation
+- [PHP](https://www.php.net) - Programming Language
+- [Composer](https://getcomposer.org) - Dependency Management
+- [PHPUnit](https://phpunit.de) - Testing the code
+- [Github Actions](https://github.com/features/actions) - Automatic CI (Testing)
+- [Read the docs](https://readthedocs.org) - Documentation
 
 ## Contributing
 
-Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
+Please read [CONTRIBUTING.md][contributing] for details on our code of conduct and the process for submitting pull requests.
+
+This project uses [Conventional Commits](https://www.conventionalcommits.org/).
 
 ## Versioning
 
-We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/D3strukt0r/votifier-client-php/tags).
+We use [SemVer](http://semver.org/) for versioning. For available versions, see the [tags on this repository][gh-tags].
 
 ## Authors
 
--   **Manuele Vaccari** - [D3strukt0r](https://github.com/D3strukt0r) - _Initial work_
+### Special thanks for all the people who had helped this project so far
+
+- **Manuele** - [D3strukt0r](https://github.com/D3strukt0r)
+
+See also the full list of [contributors][gh-contributors] who participated in this project.
+
+### I would like to join this list. How can I help the project?
+
+We're currently looking for contributions for the following:
+
+- [ ] Bug fixes
+- [ ] Translations
+- [ ] etc...
 
-See also the list of [contributors](https://github.com/D3strukt0r/votifier-client-php/contributors) who participated in this project.
+For more information, please refer to our [CONTRIBUTING.md][contributing] guide.
 
 ## License
 
-This project is licensed under the GNU General Public License v3.0 - see the [LICENSE.txt](LICENSE.txt) file for details
+This project is licensed under the MIT License - see the [LICENSE.txt](LICENSE.txt) file for details.
 
 ## Acknowledgments
 
--   Hat tip to anyone whose code was used
--   Inspiration
--   etc
+- Hat tip to anyone whose code was used
+- Inspiration
+- etc
 
-[license]: https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt
 [packagist]: https://packagist.org/packages/d3strukt0r/votifier-client
-[gh-action]: https://github.com/D3strukt0r/votifier-client-php/actions
+[gh-action]: https://github.com/Team-MaRo/votifier-client-php/actions
 [coveralls]: https://coveralls.io/github/D3strukt0r/votifier-client-php
 [scrutinizer]: https://scrutinizer-ci.com/g/D3strukt0r/votifier-client-php/
 [codacy]: https://www.codacy.com/manual/D3strukt0r/votifier-client-php
 [rtfd]: https://readthedocs.org/projects/votifier-client-php/
+[gh-tags]: https://github.com/Team-MaRo/votifier-client-php/tags
+[gh-contributors]: https://github.com/Team-MaRo/votifier-client-php/contributors
+[contributing]: https://github.com/Team-MaRo/.github/blob/master/CONTRIBUTING.md
+[code-of-conduct]: https://github.com/Team-MaRo/.github/blob/master/CODE_OF_CONDUCT.md
diff --git a/src/Exception/NotVotifierException.php b/src/Exception/NotVotifierException.php
index fe62c89..dd48474 100644
--- a/src/Exception/NotVotifierException.php
+++ b/src/Exception/NotVotifierException.php
@@ -3,11 +3,11 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client\Exception;
diff --git a/src/Exception/NuVotifierChallengeInvalidException.php b/src/Exception/NuVotifierChallengeInvalidException.php
index 07fc749..42592bb 100644
--- a/src/Exception/NuVotifierChallengeInvalidException.php
+++ b/src/Exception/NuVotifierChallengeInvalidException.php
@@ -3,11 +3,11 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client\Exception;
diff --git a/src/Exception/NuVotifierException.php b/src/Exception/NuVotifierException.php
index a7dc598..661a7d8 100644
--- a/src/Exception/NuVotifierException.php
+++ b/src/Exception/NuVotifierException.php
@@ -3,11 +3,11 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client\Exception;
diff --git a/src/Exception/NuVotifierSignatureInvalidException.php b/src/Exception/NuVotifierSignatureInvalidException.php
index 9748a88..2afd4ad 100644
--- a/src/Exception/NuVotifierSignatureInvalidException.php
+++ b/src/Exception/NuVotifierSignatureInvalidException.php
@@ -3,11 +3,11 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client\Exception;
diff --git a/src/Exception/NuVotifierUnknownServiceException.php b/src/Exception/NuVotifierUnknownServiceException.php
index df9ee9b..01db269 100644
--- a/src/Exception/NuVotifierUnknownServiceException.php
+++ b/src/Exception/NuVotifierUnknownServiceException.php
@@ -3,11 +3,11 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client\Exception;
diff --git a/src/Exception/NuVotifierUsernameTooLongException.php b/src/Exception/NuVotifierUsernameTooLongException.php
index 71272f1..6092f39 100644
--- a/src/Exception/NuVotifierUsernameTooLongException.php
+++ b/src/Exception/NuVotifierUsernameTooLongException.php
@@ -3,11 +3,11 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client\Exception;
diff --git a/src/Exception/Socket/NoConnectionException.php b/src/Exception/Socket/NoConnectionException.php
index bcdabec..81bb2b5 100644
--- a/src/Exception/Socket/NoConnectionException.php
+++ b/src/Exception/Socket/NoConnectionException.php
@@ -3,11 +3,11 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client\Exception\Socket;
diff --git a/src/Exception/Socket/PackageNotReceivedException.php b/src/Exception/Socket/PackageNotReceivedException.php
index 4495a0f..a0513e5 100644
--- a/src/Exception/Socket/PackageNotReceivedException.php
+++ b/src/Exception/Socket/PackageNotReceivedException.php
@@ -3,11 +3,11 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client\Exception\Socket;
diff --git a/src/Exception/Socket/PackageNotSentException.php b/src/Exception/Socket/PackageNotSentException.php
index 9ca3879..1ab9139 100644
--- a/src/Exception/Socket/PackageNotSentException.php
+++ b/src/Exception/Socket/PackageNotSentException.php
@@ -3,11 +3,11 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client\Exception\Socket;
diff --git a/src/Server/GenericServer.php b/src/Server/GenericServer.php
index c3a722e..e57f791 100644
--- a/src/Server/GenericServer.php
+++ b/src/Server/GenericServer.php
@@ -3,11 +3,11 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client\Server;
diff --git a/src/Server/NuVotifier.php b/src/Server/NuVotifier.php
index 4b975d6..04680b0 100644
--- a/src/Server/NuVotifier.php
+++ b/src/Server/NuVotifier.php
@@ -3,11 +3,11 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client\Server;
diff --git a/src/Server/ServerInterface.php b/src/Server/ServerInterface.php
index 81d8f9e..4e5a0c6 100644
--- a/src/Server/ServerInterface.php
+++ b/src/Server/ServerInterface.php
@@ -3,11 +3,11 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client\Server;
diff --git a/src/Server/Votifier.php b/src/Server/Votifier.php
index 3e2bb19..2d6f6f7 100644
--- a/src/Server/Votifier.php
+++ b/src/Server/Votifier.php
@@ -3,11 +3,11 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client\Server;
diff --git a/src/Socket.php b/src/Socket.php
index 79bcbce..259f75e 100644
--- a/src/Socket.php
+++ b/src/Socket.php
@@ -3,11 +3,11 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client;
diff --git a/src/Vote/ClassicVote.php b/src/Vote/ClassicVote.php
index b5f6807..86a63b3 100644
--- a/src/Vote/ClassicVote.php
+++ b/src/Vote/ClassicVote.php
@@ -3,11 +3,11 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client\Vote;
diff --git a/src/Vote/VoteInterface.php b/src/Vote/VoteInterface.php
index 43c3183..1b2c22c 100644
--- a/src/Vote/VoteInterface.php
+++ b/src/Vote/VoteInterface.php
@@ -3,11 +3,11 @@
 /**
  * Votifier PHP Client
  *
- * @package   VotifierClient
- * @author    Manuele Vaccari <manuele.vaccari@gmail.com>
- * @copyright Copyright (c) 2017-2020 Manuele Vaccari <manuele.vaccari@gmail.com>
- * @license   https://github.com/D3strukt0r/votifier-client-php/blob/master/LICENSE.txt GNU General Public License v3.0
- * @link      https://github.com/D3strukt0r/votifier-client-php
+ * @package   Votifier Client
+ * @author    Manuele Vaccari <dev@d3strukt0r.dev>
+ * @copyright Copyright (c) 2015-2020, 2026 Manuele Vaccari <dev@d3strukt0r.dev>
+ * @license   https://github.com/Team-MaRo/votifier-client-php/blob/master/LICENSE.txt MIT License
+ * @link      https://github.com/Team-MaRo/votifier-client-php
  */
 
 namespace D3strukt0r\Votifier\Client\Vote;

From 028e3ffc278f340accdb6ea57f808af78346e633 Mon Sep 17 00:00:00 2001
From: D3strukt0r <dev@d3strukt0r.dev>
Date: Tue, 30 Jun 2026 20:08:56 +0200
Subject: [PATCH 13/13] ci: add the release workflow and restrict the CI token
 to read-only

Add .github/workflows/release.yml: on every push to master, release-please scans the Conventional-Commit history, opens or updates a release PR with the version bump and CHANGELOG, and on merge cuts a GitHub Release and tag (which Packagist publishes from). It uses the default GITHUB_TOKEN with the action's documented scopes (contents, issues and pull-requests write).

Pin last-release-sha to the rebuilt "chore(master): release 3.0.0" commit (9e600310872d7589c0e599458cb224c8de5061fa). The history rewrite left the 3.0.0 tag on the old, now-unreachable commit, so release-please couldn't find the baseline and computed a 4.0.0 major from the root; this stops the commit walk at 3.0.0 so the release is the expected 3.0.1 patch without re-pointing any published tags. Once 3.0.1 is tagged on the new line release-please ignores this fallback, so it can be removed afterward.

Also add an explicit read-only permissions block to ci.yml so the style and test jobs run with a read-only token, resolving the CodeQL "workflow does not contain permissions" finding; those jobs only read the repo and upload coverage to external services.
---
 .github/release-please-config.json |  1 +
 .github/workflows/ci.yml           |  3 +++
 .github/workflows/release.yml      | 26 ++++++++++++++++++++++++++
 3 files changed, 30 insertions(+)
 create mode 100644 .github/workflows/release.yml

diff --git a/.github/release-please-config.json b/.github/release-please-config.json
index 0ea619d..da5b94a 100644
--- a/.github/release-please-config.json
+++ b/.github/release-please-config.json
@@ -3,6 +3,7 @@
   "release-type": "php",
   "include-v-in-tag": false,
   "include-component-in-tag": false,
+  "last-release-sha": "9e600310872d7589c0e599458cb224c8de5061fa",
   "changelog-sections": [
     { "type": "feat", "section": "✨ Features" },
     { "type": "fix", "section": "🐛 Bug Fixes" },
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index a2a66a9..7f6a3ac 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -21,6 +21,9 @@ on:
 
   workflow_dispatch:
 
+permissions:
+  contents: read
+
 jobs:
   # Code style (PHP-CS-Fixer), static analysis (PHPStan) and PHP-version
   # compatibility (PHP_CodeSniffer / PHPCompatibility) run once on a modern PHP.
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
new file mode 100644
index 0000000..d8fe2ab
--- /dev/null
+++ b/.github/workflows/release.yml
@@ -0,0 +1,26 @@
+name: Release
+
+# Conventional commits -> release PR -> tagged GitHub Release. release-please
+# scans the commits since the last release on master, opens (or updates) a
+# "release" PR with the version bump + CHANGELOG.md, and on merge cuts a GitHub
+# Release and git tag. Packagist publishes the new version from that tag via its
+# GitHub webhook, so no PAT/extra trigger is needed (unlike image-publishing repos).
+
+on:
+  push:
+    branches: [master]
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Create release PR / GitHub Release
+        uses: googleapis/release-please-action@v5
+        with:
+          config-file: .github/release-please-config.json
+          manifest-file: .github/release-please-manifest.json