Merge pull request #71 from cabauman/master

Add public API to unlink providers

Author: bezysoftware

src/Firebase.Auth/FirebaseAuthLink.cs

@@ -41,7 +41,7 @@ public async Task<FirebaseAuthLink> LinkToAsync(string email, string password)
         }
 
         /// <summary>
-        /// Links the this user with and account from a third party provider.
+        /// Links the user with an account from a third party provider.
         /// </summary> 
         /// <param name="authType"> The auth type.  </param>
         /// <param name="oauthAccessToken"> The access token retrieved from login provider of your choice. </param>
@@ -55,6 +55,20 @@ public async Task<FirebaseAuthLink> LinkToAsync(FirebaseAuthType authType, strin
             return this;
         }
 
+        /// <summary>
+        /// Unlinks the user from the given <see cref="authType"/> (provider).
+        /// </summary> 
+        /// <param name="authType"> The auth type.  </param>
+        /// <returns> The <see cref="FirebaseAuthLink"/>.  </returns>
+        public async Task<FirebaseAuthLink> UnlinkFromAsync(FirebaseAuthType authType)
+        {
+            var auth = await this.AuthProvider.UnlinkAccountsAsync(this, authType).ConfigureAwait(false);
+
+            this.CopyPropertiesLocally(auth.AuthProvider, auth);
+
+            return this;
+        }
+
         public async Task RefreshUserDetails()
         {
             if (this.AuthProvider != null && !string.IsNullOrEmpty(this.FirebaseToken))

src/Firebase.Auth/FirebaseAuthProvider.cs

@@ -229,7 +229,7 @@ public async Task SendEmailVerificationAsync(FirebaseAuth auth)
         }
 
         /// <summary>
-        /// Links the authenticated user represented by <see cref="auth"/> with an email and password. 
+        /// Links the given <see cref="firebaseToken"/> with an email and password. 
         /// </summary>
         /// <param name="firebaseToken"> The FirebaseToken (idToken) of an authenticated user. </param>
         /// <param name="email"> The email. </param>
@@ -255,7 +255,7 @@ public async Task<FirebaseAuthLink> LinkAccountsAsync(FirebaseAuth auth, string
         }
 
         /// <summary>
-        /// Links the authenticated user represented by <see cref="auth"/> with and account from a third party provider.
+        /// Links the given <see cref="firebaseToken"/> with an account from a third party provider.
         /// </summary>
         /// <param name="firebaseToken"> The FirebaseToken (idToken) of an authenticated user. </param>
         /// <param name="authType"> The auth type.  </param>
@@ -270,7 +270,7 @@ public async Task<FirebaseAuthLink> LinkAccountsAsync(string firebaseToken, Fire
         }
 
         /// <summary>
-        /// Links the authenticated user represented by <see cref="auth"/> with and account from a third party provider.
+        /// Links the authenticated user represented by <see cref="auth"/> with an account from a third party provider.
         /// </summary>
         /// <param name="auth"> The auth. </param>
         /// <param name="authType"> The auth type.  </param>
@@ -281,6 +281,40 @@ public async Task<FirebaseAuthLink> LinkAccountsAsync(FirebaseAuth auth, Firebas
             return await this.LinkAccountsAsync(auth.FirebaseToken, authType, oauthAccessToken).ConfigureAwait(false);
         }
 
+        /// <summary>
+        /// Unlinks the given <see cref="authType"/> from the account associated with <see cref="firebaseToken"/>.
+        /// </summary>
+        /// <param name="firebaseToken"> The FirebaseToken (idToken) of an authenticated user. </param>
+        /// <param name="authType"> The auth type.  </param>
+        /// <returns> The <see cref="FirebaseAuthLink"/>.  </returns>
+        public async Task<FirebaseAuthLink> UnlinkAccountsAsync(string firebaseToken, FirebaseAuthType authType)
+        {
+            string providerId = null;
+            if (authType == FirebaseAuthType.EmailAndPassword)
+            {
+                providerId = authType.ToEnumString();
+            }
+            else
+            {
+                providerId = this.GetProviderId(authType);
+            }
+
+            var content = $"{{\"idToken\":\"{firebaseToken}\",\"deleteProvider\":[\"{providerId}\"]}}";
+
+            return await this.ExecuteWithPostContentAsync(GoogleSetAccountUrl, content).ConfigureAwait(false);
+        }
+
+        /// <summary>
+        /// Unlinks the given <see cref="authType"/> from the authenticated user represented by <see cref="auth"/>.
+        /// </summary>
+        /// <param name="auth"> The auth. </param>
+        /// <param name="authType"> The auth type.  </param>
+        /// <returns> The <see cref="FirebaseAuthLink"/>.  </returns>
+        public async Task<FirebaseAuthLink> UnlinkAccountsAsync(FirebaseAuth auth, FirebaseAuthType authType)
+        {
+            return await this.UnlinkAccountsAsync(auth.FirebaseToken, authType).ConfigureAwait(false);
+        }
+
         /// <summary>
         /// Gets a list of accounts linked to given email.
         /// </summary>

src/Firebase.Auth/IFirebaseAuthProvider.cs

@@ -89,6 +89,22 @@ public interface IFirebaseAuthProvider
         /// <returns> The <see cref="FirebaseAuthLink"/>.  </returns>
         Task<FirebaseAuthLink> LinkAccountsAsync(string firebaseToken, FirebaseAuthType authType, string oauthAccessToken);
 
+        /// <summary>
+        /// Unlinks the given <see cref="authType"/> from the account associated with <see cref="firebaseToken"/>.
+        /// </summary>
+        /// <param name="firebaseToken"> The FirebaseToken (idToken) of an authenticated user. </param>
+        /// <param name="authType"> The auth type.  </param>
+        /// <returns> The <see cref="FirebaseAuthLink"/>.  </returns>
+        Task<FirebaseAuthLink> UnlinkAccountsAsync(string firebaseToken, FirebaseAuthType authType);
+
+        /// <summary>
+        /// Unlinks the given <see cref="authType"/> from the authenticated user represented by <see cref="auth"/>.
+        /// </summary>
+        /// <param name="auth"> The auth. </param>
+        /// <param name="authType"> The auth type.  </param>
+        /// <returns> The <see cref="FirebaseAuthLink"/>.  </returns>
+        Task<FirebaseAuthLink> UnlinkAccountsAsync(FirebaseAuth auth, FirebaseAuthType authType);
+
         /// <summary>
         /// Gets a list of accounts linked to given email.
         /// </summary>