allow method chaining

src/HOTP.php

@@ -36,7 +36,7 @@
         $htop = new self($secret);
         $htop->setCounter(self::DEFAULT_COUNTER);
         $htop->setDigest(self::DEFAULT_DIGEST);
         $htop->setDigits(self::DEFAULT_DIGITS);
 
         return $htop;
     }
@@ -49,14 +49,14 @@
     public function getCounter(): int
     {
         $value = $this->getParameter('counter');
         (is_int($value) && $value >= 0) || throw new InvalidArgumentException('Invalid "counter" parameter.');
 
         return $value;
     }
 
     public function getProvisioningUri(): string
     {
         return $this->generateURI('hotp', [
             'counter' => $this->getCounter(),
         ]);
     }
@@ -66,7 +66,7 @@
      */
     public function verify(string $otp, null|int $counter = null, null|int $window = null): bool
     {
         $counter >= 0 || throw new InvalidArgumentException('The counter must be at least 0.');
 
         if ($counter === null) {
             $counter = $this->getCounter();
@@ -77,9 +77,11 @@
         return $this->verifyOtpWithWindow($otp, $counter, $window);
     }
 
-    public function setCounter(int $counter): void
+    public function setCounter(int $counter): static
     {
         $this->setParameter('counter', $counter);
+
+        return $this;
     }
 
     /**

src/HOTPInterface.php

@@ -32,5 +32,5 @@ public static function create(
         int $digits = 6
     ): self;
 
-    public function setCounter(int $counter): void;
+    public function setCounter(int $counter): static;
 }

src/OTPInterface.php

@@ -25,14 +25,14 @@ public static function generate(): self;
     /**
      * @param non-empty-string $secret
      */
-    public function setSecret(string $secret): void;
+    public function setSecret(string $secret): static;
 
-    public function setDigits(int $digits): void;
+    public function setDigits(int $digits): static;
 
     /**
      * @param non-empty-string $digest
      */
-    public function setDigest(string $digest): void;
+    public function setDigest(string $digest): static;
 
     /**
      * @return non-empty-string Return the OTP at the specified timestamp
@@ -57,7 +57,7 @@ public function getSecret(): string;
     /**
      * @param non-empty-string $label The label of the OTP
      */
-    public function setLabel(string $label): void;
+    public function setLabel(string $label): static;
 
     /**
      * @return non-empty-string|null The label of the OTP
@@ -72,7 +72,7 @@ public function getIssuer(): ?string;
     /**
      * @param non-empty-string $issuer
      */
-    public function setIssuer(string $issuer): void;
+    public function setIssuer(string $issuer): static;
 
     /**
      * @return bool If true, the issuer will be added as a parameter in the provisioning URI

src/ParameterTrait.php

@@ -57,19 +57,23 @@ public function getLabel(): null|string
         return $this->label;
     }
 
-    public function setLabel(string $label): void
+    public function setLabel(string $label): static
     {
         $this->setParameter('label', $label);
+
+        return $this;
     }
 
     public function getIssuer(): null|string
     {
         return $this->issuer;
     }
 
-    public function setIssuer(string $issuer): void
+    public function setIssuer(string $issuer): static
     {
         $this->setParameter('issuer', $issuer);
+
+        return $this;
     }
 
     public function isIssuerIncludedAsParameter(): bool
@@ -128,19 +132,25 @@ public function setParameter(string $parameter, mixed $value): void
         }
     }
 
-    public function setSecret(string $secret): void
+    public function setSecret(string $secret): static
     {
         $this->setParameter('secret', $secret);
+
+        return $this;
     }
 
-    public function setDigits(int $digits): void
+    public function setDigits(int $digits): static
     {
         $this->setParameter('digits', $digits);
+
+        return $this;
     }
 
-    public function setDigest(string $digest): void
+    public function setDigest(string $digest): static
     {
         $this->setParameter('algorithm', $digest);
+
+        return $this;
     }
 
     /**

src/TOTP.php

@@ -138,14 +138,18 @@ public function getProvisioningUri(): string
         return $this->generateURI('totp', $params);
     }
 
-    public function setPeriod(int $period): void
+    public function setPeriod(int $period): static
     {
         $this->setParameter('period', $period);
+
+        return $this;
     }
 
-    public function setEpoch(int $epoch): void
+    public function setEpoch(int $epoch): static
     {
         $this->setParameter('epoch', $epoch);
+
+        return $this;
     }
 
     /**

src/TOTPInterface.php

@@ -29,9 +29,9 @@ public static function create(
         int $digits = self::DEFAULT_DIGITS
     ): self;
 
-    public function setPeriod(int $period): void;
+    public function setPeriod(int $period): static;
 
-    public function setEpoch(int $epoch): void;
+    public function setEpoch(int $epoch): static;
 
     /**
      * Return the TOTP at the current time.