Add deprecation notices for removals in v7 major release

src/API/Helpers/State/DummyStateHandler.php

@@ -14,6 +14,8 @@
 /**
  * Dummy implementation of the StateHandler
  *
+ * @deprecated 5.7.0, no replacement provided.
+ *
  * @author Auth0
  */
 class DummyStateHandler implements StateHandler

src/API/Helpers/State/SessionStateHandler.php

@@ -16,6 +16,8 @@
 /**
  * Session based implementation of StateHandler.
  *
+ * @deprecated 5.7.0, replaced by Auth0\SDK\Helpers\TransientStoreHandler
+ *
  * @author Auth0
  */
 class SessionStateHandler implements StateHandler

src/API/Helpers/State/StateHandler.php

@@ -14,6 +14,8 @@
 /**
  * This interface must be implemented by state handlers.
  *
+ * @deprecated 5.7.0, replaced by Auth0\SDK\Helpers\TransientStoreHandler
+ *
  * @author Auth0
  */
 interface StateHandler

src/Helpers/Cache/CacheHandler.php

@@ -2,6 +2,9 @@
 
 namespace Auth0\SDK\Helpers\Cache;
 
+/**
+ * @deprecated 5.7.0, switching to Psr\SimpleCache\CacheInterface in 7.0.0
+ */
 interface CacheHandler
 {
 

src/Helpers/Cache/FileSystemCacheHandler.php

@@ -2,6 +2,9 @@
 
 namespace Auth0\SDK\Helpers\Cache;
 
+/**
+ * @deprecated 5.7.0, use a Psr\SimpleCache\CacheInterface in 7.0.0.
+ */
 class FileSystemCacheHandler implements CacheHandler
 {
 

src/JWTVerifier.php

@@ -13,6 +13,8 @@
  * Class JWTVerifier.
  * Used to validate JWTs issued by Auth0.
  *
+ * @deprecated 5.7.0, replacement available in upcoming 7.0.0: Auth0\SDK\Helpers\Tokens\IdTokenVerifier
+ *
  * @package Auth0\SDK
  */
 class JWTVerifier

src/Store/EmptyStore.php

@@ -17,6 +17,8 @@
  * This class is a mockup store, that discards the values, its a way of saying no store.
  *
  * @author Auth0
+ *
+ * @deprecated 5.7.0, no replacement provided.
  */
 class EmptyStore implements StoreInterface
 {

src/Store/SessionStore.php

@@ -37,7 +37,7 @@ class SessionStore implements StoreInterface
      * SessionStore constructor.
      *
      * @param string  $base_name      Session base name.
-     * @param integer $cookie_expires Session expiration in seconds; default is 1 week.
+     * @param integer $cookie_expires Session expiration in seconds; default is 1 week - @deprecated 5.7.0
      */
     public function __construct($base_name = self::BASE_NAME, $cookie_expires = self::COOKIE_EXPIRES)
     {