Couple more updates to docs

composer.json

@@ -30,9 +30,7 @@
     "consolidation/output-formatters": "^3.2.0",
     "drupal/dynamic_entity_reference": "^2.0@alpha",
     "drupal/encrypt": "^3.0@rc",
-    "drupal/key": "^1.7",
     "lusitanian/oauth": "^0.8.11",
-    "firebase/php-jwt": "^5.0",
     "messageagency/force.com-toolkit-for-php": "^1.0.0"
   }
 }

src/Rest/RestClient.php

@@ -95,7 +95,7 @@ class RestClient implements RestClientInterface {
    *
    * @var \Drupal\salesforce\Storage\SalesforceAuthTokenStorage
    *
-   * @deprecated interim, do not use.
+   * @deprecated BC legacy auth scheme only, do not use, will be removed.
    */
   private $storage;
 
@@ -137,7 +137,7 @@ class RestClient implements RestClientInterface {
    * @return \Drupal\salesforce\Storage\SalesforceAuthTokenStorage
    *   The auth token storage service.
    *
-   * @deprecated interim, do not use.
+   * @deprecated BC legacy auth scheme only, do not use, will be removed.
    */
   private function storage() {
     if (!$this->storage) {

src/SalesforceAuthProviderPluginManager.php

@@ -61,7 +61,7 @@ class SalesforceAuthProviderPluginManager extends DefaultPluginManager {
   /**
    * Backwards-compatibility for legacy singleton auth.
    *
-   * @deprecated interim, do not use.
+   * @deprecated BC legacy auth scheme only, do not use, will be removed.
    */
   public static function updateAuthConfig() {
     $oauth = self::getAuthConfig();
@@ -79,7 +79,7 @@ class SalesforceAuthProviderPluginManager extends DefaultPluginManager {
   /**
    * Backwards-compatibility for legacy singleton auth.
    *
-   * @deprecated interim, do not use.
+   * @deprecated BC legacy auth scheme only, do not use, will be removed.
    */
   public static function getAuthConfig() {
     $config = \Drupal::configFactory()->getEditable('salesforce.settings');

src/Storage/SalesforceAuthTokenStorage.php

@@ -40,7 +40,7 @@ class SalesforceAuthTokenStorage implements SalesforceAuthTokenStorageInterface
    * @return string
    *   Id of the active oauth.
    *
-   * @deprecated interim, do not use.
+   * @deprecated BC legacy auth scheme only, do not use, will be removed.
    */
   private function service() {
     $oauth = SalesforceAuthProviderPluginManager::getAuthConfig();
@@ -50,7 +50,7 @@ class SalesforceAuthTokenStorage implements SalesforceAuthTokenStorageInterface
   /**
    * Backwards-compatibility for legacy singleton auth.
    *
-   * @deprecated interim, do not use.
+   * @deprecated BC legacy auth scheme only, do not use, will be removed.
    */
   public function updateToken() {
     $this->storeAccessToken($this->service(),
@@ -63,7 +63,7 @@ class SalesforceAuthTokenStorage implements SalesforceAuthTokenStorageInterface
   /**
    * Backwards-compatibility for legacy singleton auth.
    *
-   * @deprecated interim, do not use.
+   * @deprecated BC legacy auth scheme only, do not use, will be removed.
    */
   public function updateIdentity() {
     $this->storeIdentity($this->service(), $this->state->get('salesforce.identity'));
@@ -143,6 +143,7 @@ class SalesforceAuthTokenStorage implements SalesforceAuthTokenStorageInterface
    */
   public function clearAllTokens() {
     // noop. We don't do this. Only here to satisfy interface.
+    return $this;
   }
 
   /**
@@ -180,6 +181,7 @@ class SalesforceAuthTokenStorage implements SalesforceAuthTokenStorageInterface
    */
   public function clearAllAuthorizationStates() {
     // noop. only here to satisfy interface. Use clearAuthorizationState().
+    return $this;
   }
 
   /**