update docs

Author: carl-alexander-adams

src/planet_auth/oidc/token_validator.py

@@ -14,7 +14,7 @@
 
 import jwt
 import time
-from typing import Dict, List
+from typing import Any, Dict, List, Tuple
 
 import planet_auth.logging.auth_logger
 from planet_auth.auth_exception import AuthException, InvalidTokenException
@@ -258,13 +258,16 @@ def validate_token(
 
     @staticmethod
     @InvalidArgumentException.recast(jwt.exceptions.DecodeError)
-    def hazmat_unverified_decode(token_str):
+    def hazmat_unverified_decode(token_str) -> Tuple[Dict, Dict, Any]:
         """
         Decide a JWT without verifying the signature or any claims.
 
         !!! Warning
             Treat unverified token claims with extreme caution.
             Nothing can be trusted until the token is verified.
+
+        Returns:
+            Returns the decoded JWT header, payload, and signature
         """
         unverified_complete = jwt.decode_complete(token_str, options={"verify_signature": False})  # nosemgrep
         return unverified_complete["header"], unverified_complete["payload"], unverified_complete["signature"]