Initial commit

Author: eldadfux

docs/auth.md

@@ -1,6 +1,6 @@
 # Auth Service
 
-## Login User
+## Login
 
 ```http request
 POST https://appwrite.io/v1/auth/login
@@ -21,6 +21,20 @@ When accessing this route using Javascript from the browser, success and failure
 | success | string | URL to redirect back to your app after a successful login attempt. |  |
 | failure | string | URL to redirect back to your app after a failed login attempt. |  |
 
+## Login with OAuth
+
+```http request
+GET https://appwrite.io/v1/auth/login/oauth/{provider}
+```
+
+### Parameters
+
+| Field Name | Type | Description | Default |
+| --- | --- | --- | --- |
+| provider | string | **Required** OAuth Provider |  |
+| success | string | **Required** URL to redirect back to your app after a successful login attempt. |  |
+| failure | string | **Required** URL to redirect back to your app after a failed login attempt. |  |
+
 ## Logout Current Session
 
 ```http request
@@ -43,20 +57,6 @@ DELETE https://appwrite.io/v1/auth/logout/{id}
 | --- | --- | --- | --- |
 | id | string | **Required** User specific session unique ID number. if 0 delete all sessions. |  |
 
-## OAuth Login
-
-```http request
-GET https://appwrite.io/v1/auth/oauth/{provider}
-```
-
-### Parameters
-
-| Field Name | Type | Description | Default |
-| --- | --- | --- | --- |
-| provider | string | **Required** OAuth Provider |  |
-| success | string | **Required** URL to redirect back to your app after a successful login attempt. |  |
-| failure | string | **Required** URL to redirect back to your app after a failed login attempt. |  |
-
 ## Password Recovery
 
 ```http request
@@ -91,7 +91,7 @@ Please notice that in order to avoid a [Redirect Attack](https://github.com/OWAS
 | password-a | string | New password. |  |
 | password-b | string | New password again. |  |
 
-## Register User
+## Register
 
 ```http request
 POST https://appwrite.io/v1/auth/register
@@ -116,7 +116,7 @@ When accessing this route using Javascript from the browser, success and failure
 | failure | string | Redirect when registration failed |  |
 | name | string | User name |  |
 
-## Confirm User
+## Confirmation
 
 ```http request
 POST https://appwrite.io/v1/auth/register/confirm

src/Appwrite/Services/Auth.php

@@ -9,7 +9,7 @@
 class Auth extends Service
 {
     /**
-     * Login User
+     * Login
      *
      * Allow the user to login into his account by providing a valid email and
      * password combination. Use the success and failure arguments to provide a
@@ -48,6 +48,28 @@ public function login(string $email, string $password, string $success = '', str
         ], $params);
     }
 
+    /**
+     * Login with OAuth
+     *
+     * @param string  $provider
+     * @param string  $success
+     * @param string  $failure
+     * @throws Exception
+     * @return array
+     */
+    public function oauth(string $provider, string $success, string $failure):array
+    {
+        $path   = str_replace(['{provider}'], [$provider], '/auth/login/oauth/{provider}');
+        $params = [];
+
+        $params['success'] = $success;
+        $params['failure'] = $failure;
+
+        return $this->client->call(Client::METHOD_GET, $path, [
+            'content-type' => 'application/json',
+        ], $params);
+    }
+
     /**
      * Logout Current Session
      *
@@ -91,28 +113,6 @@ public function logoutBySession(string $id):array
         ], $params);
     }
 
-    /**
-     * OAuth Login
-     *
-     * @param string  $provider
-     * @param string  $success
-     * @param string  $failure
-     * @throws Exception
-     * @return array
-     */
-    public function oauth(string $provider, string $success, string $failure):array
-    {
-        $path   = str_replace(['{provider}'], [$provider], '/auth/oauth/{provider}');
-        $params = [];
-
-        $params['success'] = $success;
-        $params['failure'] = $failure;
-
-        return $this->client->call(Client::METHOD_GET, $path, [
-            'content-type' => 'application/json',
-        ], $params);
-    }
-
     /**
      * Password Recovery
      *
@@ -177,7 +177,7 @@ public function recoveryReset(string $userId, string $token, string $passwordA,
     }
 
     /**
-     * Register User
+     * Register
      *
      * Use this endpoint to allow a new user to register an account in your
      * project. Use the success and failure URLs to redirect users back to your
@@ -227,7 +227,7 @@ public function register(string $email, string $password, string $confirm, strin
     }
 
     /**
-     * Confirm User
+     * Confirmation
      *
      * Use this endpoint to complete the confirmation of the user account email
      * address. Both the **userId** and **token** arguments will be passed as