From 9faaf533046a0cfec60facffd4478cdd5d2d3c13 Mon Sep 17 00:00:00 2001
From: Henrik Andersson <henrik.a.andersson@outlook.com>
Date: Sun, 15 Mar 2015 09:44:24 +1000
Subject: [PATCH] Add methods to interface :no_mouth:  and observable client

---
 .../IObservableAuthorizationsClient.cs        | 46 ++++++++++++
 .../Clients/ObservableAuthorizationsClient.cs | 74 +++++++++++++++++++
 Octokit/Clients/AuthorizationsClient.cs       |  2 +-
 Octokit/Clients/IAuthorizationsClient.cs      | 46 ++++++++++++
 4 files changed, 167 insertions(+), 1 deletion(-)

diff --git a/Octokit.Reactive/Clients/IObservableAuthorizationsClient.cs b/Octokit.Reactive/Clients/IObservableAuthorizationsClient.cs
index 4c6894a0..c62e47f7 100644
--- a/Octokit.Reactive/Clients/IObservableAuthorizationsClient.cs
+++ b/Octokit.Reactive/Clients/IObservableAuthorizationsClient.cs
@@ -77,6 +77,52 @@ namespace Octokit.Reactive
             NewAuthorization newAuthorization,
             string twoFactorAuthenticationCode);
 
+        /// <summary>
+        /// </summary>
+        /// <remarks>
+        /// This method requires authentication.
+        /// See the <a href="https://developer.github.com/v3/oauth_authorizations/#check-an-authorization">API documentation</a> for more information.
+        /// </remarks>
+        /// <param name="clientId">Client ID of the OAuth application for the token</param>
+        /// <param name="accessToken">The OAuth token to check</param>
+        /// <returns>The valid <see cref="ApplicationAuthorization"/>.</returns>
+        IObservable<ApplicationAuthorization> CheckApplicationAuthentication(string clientId, string accessToken);
+
+        /// <summary>
+        /// Resets a valid OAuth token for an OAuth application without end user involvment.
+        /// </summary>
+        /// <remarks>
+        /// This method requires authentication.
+        /// See the <a href="https://developer.github.com/v3/oauth_authorizations/#reset-an-authorization">API documentation</a> for more information.
+        /// </remarks>
+        /// <param name="clientId">ClientID of the OAuth application for the token</param>
+        /// <param name="accessToken">The OAuth token to reset</param>
+        /// <returns>The valid <see cref="ApplicationAuthorization"/> with a new OAuth token</returns>
+        IObservable<ApplicationAuthorization> ResetApplicationAuthentication(string clientId, string accessToken);
+
+        /// <summary>
+        /// Revokes a single OAuth token for an OAuth application.
+        /// </summary>
+        /// <remarks>
+        /// This method requires authentication.
+        /// See the <a href="https://developer.github.com/v3/oauth_authorizations/#revoke-an-authorization-for-an-application">API documentation for more information.</a>
+        /// </remarks>
+        /// <param name="clientId">ClientID of the OAuth application for the token</param>
+        /// <param name="accessToken">The OAuth token to revoke</param>
+        /// <returns></returns>
+        IObservable<Unit> RevokeApplicationAuthentication(string clientId, string accessToken);
+
+        /// <summary>
+        /// Revokes every OAuth token for an OAuth application.
+        /// </summary>
+        /// <remarks>
+        /// This method requires authentication.
+        /// See the <a href="https://developer.github.com/v3/oauth_authorizations/#revoke-all-authorizations-for-an-application">API documentation for more information.</a>
+        /// </remarks>
+        /// <param name="clientId">ClientID of the OAuth application for the token</param>
+        /// <returns></returns>
+        IObservable<Unit> RevokeAllApplicationAuthentications(string clientId);
+
         /// <summary>
         /// Update the <see cref="Authorization"/> specified by the id.
         /// </summary>
diff --git a/Octokit.Reactive/Clients/ObservableAuthorizationsClient.cs b/Octokit.Reactive/Clients/ObservableAuthorizationsClient.cs
index 88a8cc04..6485729b 100644
--- a/Octokit.Reactive/Clients/ObservableAuthorizationsClient.cs
+++ b/Octokit.Reactive/Clients/ObservableAuthorizationsClient.cs
@@ -112,6 +112,80 @@ namespace Octokit.Reactive
                 .ToObservable();
         }
 
+
+        /// <summary>
+        /// </summary>
+        /// <remarks>
+        /// This method requires authentication.
+        /// See the <a href="https://developer.github.com/v3/oauth_authorizations/#check-an-authorization">API documentation</a> for more information.
+        /// </remarks>
+        /// <param name="clientId">Client ID of the OAuth application for the token</param>
+        /// <param name="accessToken">The OAuth token to check</param>
+        /// <returns>The valid <see cref="ApplicationAuthorization"/>.</returns>
+        public IObservable<ApplicationAuthorization> CheckApplicationAuthentication(string clientId, string accessToken)
+        {
+            Ensure.ArgumentNotNullOrEmptyString("clientId", clientId);
+            Ensure.ArgumentNotNullOrEmptyString("accessToken", accessToken);
+
+            return _client.CheckApplicationAuthentication(clientId, accessToken)
+                .ToObservable();
+        }
+
+        /// <summary>
+        /// Resets a valid OAuth token for an OAuth application without end user involvment.
+        /// </summary>
+        /// <remarks>
+        /// This method requires authentication.
+        /// See the <a href="https://developer.github.com/v3/oauth_authorizations/#reset-an-authorization">API documentation</a> for more information.
+        /// </remarks>
+        /// <param name="clientId">ClientID of the OAuth application for the token</param>
+        /// <param name="accessToken">The OAuth token to reset</param>
+        /// <returns>The valid <see cref="ApplicationAuthorization"/> with a new OAuth token</returns>
+        public IObservable<ApplicationAuthorization> ResetApplicationAuthentication(string clientId, string accessToken)
+        {
+            Ensure.ArgumentNotNullOrEmptyString("clientId", clientId);
+            Ensure.ArgumentNotNullOrEmptyString("accessToken", accessToken);
+
+            return _client.ResetApplicationAuthentication(clientId, accessToken)
+                .ToObservable();
+        }
+
+        /// <summary>
+        /// Revokes a single OAuth token for an OAuth application.
+        /// </summary>
+        /// <remarks>
+        /// This method requires authentication.
+        /// See the <a href="https://developer.github.com/v3/oauth_authorizations/#revoke-an-authorization-for-an-application">API documentation for more information.</a>
+        /// </remarks>
+        /// <param name="clientId">ClientID of the OAuth application for the token</param>
+        /// <param name="accessToken">The OAuth token to revoke</param>
+        /// <returns></returns>
+        public IObservable<Unit> RevokeApplicationAuthentication(string clientId, string accessToken)
+        {
+            Ensure.ArgumentNotNullOrEmptyString("clientId", clientId);
+            Ensure.ArgumentNotNullOrEmptyString("accessToken", accessToken);
+
+            return _client.RevokeApplicationAuthentication(clientId, accessToken)
+                .ToObservable();
+        }
+
+        /// <summary>
+        /// Revokes every OAuth token for an OAuth application.
+        /// </summary>
+        /// <remarks>
+        /// This method requires authentication.
+        /// See the <a href="https://developer.github.com/v3/oauth_authorizations/#revoke-all-authorizations-for-an-application">API documentation for more information.</a>
+        /// </remarks>
+        /// <param name="clientId">ClientID of the OAuth application for the token</param>
+        /// <returns></returns>
+        public IObservable<Unit> RevokeAllApplicationAuthentications(string clientId)
+        {
+            Ensure.ArgumentNotNullOrEmptyString("clientId", clientId);
+
+            return _client.RevokeAllApplicationAuthentications(clientId)
+                .ToObservable();
+        }
+
         /// <summary>
         /// Update the <see cref="Authorization"/> specified by the id.
         /// </summary>
diff --git a/Octokit/Clients/AuthorizationsClient.cs b/Octokit/Clients/AuthorizationsClient.cs
index 1eea4c7b..b98b7fde 100644
--- a/Octokit/Clients/AuthorizationsClient.cs
+++ b/Octokit/Clients/AuthorizationsClient.cs
@@ -175,6 +175,7 @@ namespace Octokit
                 throw new TwoFactorChallengeFailedException(e);
             }
         }
+
         /// <summary>
         /// </summary>
         /// <remarks>
@@ -182,7 +183,6 @@ namespace Octokit
         /// See the <a href="https://developer.github.com/v3/oauth_authorizations/#check-an-authorization">API documentation</a> for more information.
         /// </remarks>
         /// <param name="clientId">Client ID of the OAuth application for the token</param>
-        /// <param name="clientSecret">The client secret</param>
         /// <param name="accessToken">The OAuth token to check</param>
         /// <returns>The valid <see cref="ApplicationAuthorization"/>.</returns>
         public async Task<ApplicationAuthorization> CheckApplicationAuthentication(string clientId, string accessToken)
diff --git a/Octokit/Clients/IAuthorizationsClient.cs b/Octokit/Clients/IAuthorizationsClient.cs
index a08b97e0..aeb25cd7 100644
--- a/Octokit/Clients/IAuthorizationsClient.cs
+++ b/Octokit/Clients/IAuthorizationsClient.cs
@@ -99,6 +99,52 @@ namespace Octokit
             NewAuthorization newAuthorization,
             string twoFactorAuthenticationCode);
 
+        /// <summary>
+        /// </summary>
+        /// <remarks>
+        /// This method requires authentication.
+        /// See the <a href="https://developer.github.com/v3/oauth_authorizations/#check-an-authorization">API documentation</a> for more information.
+        /// </remarks>
+        /// <param name="clientId">Client ID of the OAuth application for the token</param>
+        /// <param name="accessToken">The OAuth token to check</param>
+        /// <returns>The valid <see cref="ApplicationAuthorization"/>.</returns>
+        Task<ApplicationAuthorization> CheckApplicationAuthentication(string clientId, string accessToken);
+
+        /// <summary>
+        /// Resets a valid OAuth token for an OAuth application without end user involvment.
+        /// </summary>
+        /// <remarks>
+        /// This method requires authentication.
+        /// See the <a href="https://developer.github.com/v3/oauth_authorizations/#reset-an-authorization">API documentation</a> for more information.
+        /// </remarks>
+        /// <param name="clientId">ClientID of the OAuth application for the token</param>
+        /// <param name="accessToken">The OAuth token to reset</param>
+        /// <returns>The valid <see cref="ApplicationAuthorization"/> with a new OAuth token</returns>
+        Task<ApplicationAuthorization> ResetApplicationAuthentication(string clientId, string accessToken);
+
+        /// <summary>
+        /// Revokes a single OAuth token for an OAuth application.
+        /// </summary>
+        /// <remarks>
+        /// This method requires authentication.
+        /// See the <a href="https://developer.github.com/v3/oauth_authorizations/#revoke-an-authorization-for-an-application">API documentation for more information.</a>
+        /// </remarks>
+        /// <param name="clientId">ClientID of the OAuth application for the token</param>
+        /// <param name="accessToken">The OAuth token to revoke</param>
+        /// <returns>A <see cref="Task"/> for the request's execution.</returns>
+        Task RevokeApplicationAuthentication(string clientId, string accessToken);
+
+        /// <summary>
+        /// Revokes every OAuth token for an OAuth application.
+        /// </summary>
+        /// <remarks>
+        /// This method requires authentication.
+        /// See the <a href="https://developer.github.com/v3/oauth_authorizations/#revoke-all-authorizations-for-an-application">API documentation for more information.</a>
+        /// </remarks>
+        /// <param name="clientId">ClientID of the OAuth application for the token</param>
+        /// <returns>A <see cref="Task"/> for the request's execution.</returns>
+        Task RevokeAllApplicationAuthentications(string clientId);
+
         /// <summary>
         /// Updates the specified <see cref="Authorization"/>.
         /// </summary>