290 - Mark interfaces as api, refactoring interfaces

Author: Andrii Chornyi

TwoFactorAuth/Api/AdminTokenServiceInterface.php

@@ -12,6 +12,7 @@
 
 /**
  * Obtain basic information about the user required to setup or use 2fa
+ * @api
  */
 interface AdminTokenServiceInterface extends OriginalTokenServiceInterface
 {

TwoFactorAuth/Api/AuthyAuthenticateInterface.php

@@ -10,6 +10,7 @@
 
 /**
  * Represents the authy provider authentication
+ * @api
  */
 interface AuthyAuthenticateInterface
 {

TwoFactorAuth/Api/AuthyConfigureInterface.php

@@ -13,6 +13,7 @@
 
 /**
  * Represents the authy provider
+ * @api
  */
 interface AuthyConfigureInterface
 {
@@ -21,7 +22,7 @@ interface AuthyConfigureInterface
      *
      * @param string $tfaToken
      * @param AuthyDeviceInterface $deviceData
-     * @return \Magento\TwoFactorAuth\Api\Data\AuthyRegistrationPromptResponseInterface
+     * @return ResponseInterface
      */
     public function sendDeviceRegistrationPrompt(
         string $tfaToken,

TwoFactorAuth/Api/CountryRepositoryInterface.php

@@ -14,7 +14,7 @@
 
 /**
  * Countries repository
- *
+ * @api
  * @SuppressWarnings(PHPMD.ShortVariable)
  */
 interface CountryRepositoryInterface

TwoFactorAuth/Api/Data/AdminTokenResponseInterface.php

@@ -9,9 +9,11 @@
 namespace Magento\TwoFactorAuth\Api\Data;
 
 use Magento\Framework\Api\ExtensibleDataInterface;
+use Magento\TwoFactorAuth\Api\ProviderInterface;
 
 /**
  * Represents the response to the new admin token response
+ * @api
  */
 interface AdminTokenResponseInterface extends ExtensibleDataInterface
 {
@@ -63,14 +65,14 @@ public function setMessage(string $value): void;
     /**
      * Get the providers
      *
-     * @return \Magento\TwoFactorAuth\Api\ProviderInterface[]
+     * @return ProviderInterface[]
      */
     public function getActiveProviders(): array;
 
     /**
      * Set the providers
      *
-     * @param \Magento\TwoFactorAuth\Api\ProviderInterface[] $value
+     * @param ProviderInterface[] $value
      * @return void
      */
     public function setActiveProviders(array $value): void;
@@ -80,14 +82,14 @@ public function setActiveProviders(array $value): void;
      *
      * Used fully qualified namespaces in annotations for proper work of extension interface/class code generation
      *
-     * @return \Magento\TwoFactorAuth\Api\Data\AdminTokenResponseExtensionInterface|null
+     * @return AdminTokenResponseExtensionInterface|null
      */
     public function getExtensionAttributes(): ?AdminTokenResponseExtensionInterface;
 
     /**
      * Set an extension attributes object
      *
-     * @param \Magento\TwoFactorAuth\Api\Data\AdminTokenResponseExtensionInterface $extensionAttributes
+     * @param AdminTokenResponseExtensionInterface $extensionAttributes
      * @return void
      */
     public function setExtensionAttributes(

TwoFactorAuth/Api/Data/AuthyDeviceInterface.php

@@ -11,6 +11,7 @@
 
 /**
  * Authy device data interface
+ * @api
  */
 interface AuthyDeviceInterface extends ExtensibleDataInterface
 {
@@ -89,14 +90,14 @@ public function setMethod(string $value): void;
      *
      * Used fully qualified namespaces in annotations for proper work of extension interface/class code generation
      *
-     * @return \Magento\TwoFactorAuth\Api\Data\AuthyDeviceExtensionInterface|null
+     * @return AuthyDeviceExtensionInterface|null
      */
     public function getExtensionAttributes(): ?AuthyDeviceExtensionInterface;
 
     /**
      * Set an extension attributes object
      *
-     * @param \Magento\TwoFactorAuth\Api\Data\AuthyDeviceExtensionInterface $extensionAttributes
+     * @param AuthyDeviceExtensionInterface $extensionAttributes
      * @return void
      */
     public function setExtensionAttributes(

TwoFactorAuth/Api/Data/AuthyRegistrationPromptResponseInterface.php

@@ -12,6 +12,7 @@
 
 /**
  * Response for device registration prompt
+ * @api
  */
 interface AuthyRegistrationPromptResponseInterface extends ExtensibleDataInterface
 {
@@ -60,14 +61,14 @@ public function setExpirationSeconds(int $value): void;
      *
      * Used fully qualified namespaces in annotations for proper work of extension interface/class code generation
      *
-     * @return \Magento\TwoFactorAuth\Api\Data\AuthyRegistrationPromptResponseExtensionInterface|null
+     * @return AuthyRegistrationPromptResponseExtensionInterface|null
      */
     public function getExtensionAttributes(): ?AuthyRegistrationPromptResponseExtensionInterface;
 
     /**
      * Set an extension attributes object
      *
-     * @param \Magento\TwoFactorAuth\Api\Data\AuthyRegistrationPromptResponseExtensionInterface $extensionAttributes
+     * @param AuthyRegistrationPromptResponseExtensionInterface $extensionAttributes
      * @return void
      */
     public function setExtensionAttributes(

TwoFactorAuth/Api/Data/CountryInterface.php

@@ -11,6 +11,7 @@
 
 /**
  * Country entity interface
+ * @api
  */
 interface CountryInterface extends ExtensibleDataInterface
 {
@@ -95,14 +96,14 @@ public function setDialCode(string $value): void;
      *
      * Used fully qualified namespaces in annotations for proper work of extension interface/class code generation
      *
-     * @return \Magento\TwoFactorAuth\Api\Data\CountryExtensionInterface|null
+     * @return CountryExtensionInterface|null
      */
     public function getExtensionAttributes(): ?CountryExtensionInterface;
 
     /**
      * Set an extension attributes object
      *
-     * @param \Magento\TwoFactorAuth\Api\Data\CountryExtensionInterface $extensionAttributes
+     * @param CountryExtensionInterface $extensionAttributes
      */
     public function setExtensionAttributes(
         CountryExtensionInterface $extensionAttributes

TwoFactorAuth/Api/Data/CountrySearchResultsInterface.php

@@ -11,6 +11,7 @@
 
 /**
  * Represent country search results
+ * @api
  */
 interface CountrySearchResultsInterface extends SearchResultsInterface
 {

TwoFactorAuth/Api/Data/DuoDataInterface.php

@@ -11,6 +11,7 @@
 
 /**
  * Represents the data needed to use duo
+ * @api
  */
 interface DuoDataInterface extends ExtensibleDataInterface
 {
@@ -59,14 +60,14 @@ public function setApiHostname(string $value): void;
      *
      * Used fully qualified namespaces in annotations for proper work of extension interface/class code generation
      *
-     * @return \Magento\TwoFactorAuth\Api\Data\DuoDataExtensionInterface|null
+     * @return DuoDataExtensionInterface|null
      */
     public function getExtensionAttributes(): ?DuoDataExtensionInterface;
 
     /**
      * Set an extension attributes object
      *
-     * @param \Magento\TwoFactorAuth\Api\Data\DuoDataExtensionInterface $extensionAttributes
+     * @param DuoDataExtensionInterface $extensionAttributes
      * @return void
      */
     public function setExtensionAttributes(