feat(gotrue): add accessToken to signInWithIdToken method (#520)

* feat(gotrue): add accessToken parameter to signInWithIdToken method

* revert changes that accidently got mixed

* add more docs on signInWithIdToken method

* Update packages/gotrue/lib/src/gotrue_client.dart

Co-authored-by: Vinzent <vinzent03@proton.me>

---------

Co-authored-by: Vinzent <vinzent03@proton.me>

packages/gotrue/lib/src/gotrue_client.dart

@@ -302,11 +302,21 @@ class GoTrueClient {
   /// The [idToken] is verified for validity and a new session is established.
   /// This method of signing in only supports [Provider.google] or [Provider.apple].
   ///
+  /// If the ID token contains an `at_hash` claim, then [accessToken] must be
+  /// provided to compare its hash with the value in the ID token.
+  ///
+  /// If the ID token contains a `nonce` claim, then [nonce] must be
+  /// provided to compare its hash with the value in the ID token.
+  ///
+  /// [captchaToken] is the verification token received when the user
+  /// completes the captcha on the app.
+  ///
   /// This method is experimental.
   @experimental
   Future<AuthResponse> signInWithIdToken({
     required Provider provider,
     required String idToken,
+    String? accessToken,
     String? nonce,
     String? captchaToken,
   }) async {
@@ -327,6 +337,7 @@ class GoTrueClient {
           'id_token': idToken,
           'nonce': nonce,
           'gotrue_meta_security': {'captcha_token': captchaToken},
+          'access_token': accessToken,
         },
         query: {'grant_type': 'id_token'},
       ),