Added Client POST methods to Oauth2 Facade;

Author: olimar

Providers/OpenIdServiceProvider.php

@@ -108,7 +108,7 @@ protected function registerBladeDirectives()
         });
 
         Blade::directive('login', function ($route) {
-            if(\Auth::check()) return route($route);
+            if(\Auth::check()) return "<?php echo route($route); ?>";
 
             return "<?php echo config('openid.server') . '/login?' . http_build_query(['continue' => route($route)]); ?>";
         });

README.md

@@ -35,7 +35,7 @@ The file `config/openid.php` will be generated.
 In the file `app\Exceptions\Handler.php` find or overwrite the `unauthenticated` method and change the redirect route to:
 
 ```php
-    config('server') . '/login?continue=' . env('APP_URL')
+config('openid.server') . '/login?continue=' . env('APP_URL')
 ```
 
 **PS:** Don't forget change the `SESSION_LIFETIME` in the .env file to the time in minutes you want to keep the logged session.
@@ -44,7 +44,7 @@ In the file `app\Exceptions\Handler.php` find or overwrite the `unauthenticated`
 
 change the file `config\auth.php` to:
 
-```
+```php
 'guards' => [
     'web' => [
         'driver' => 'openid',
@@ -66,22 +66,24 @@ The client methods are available under the facade OpenId.
 
 The authentication methods like the verifier `\Auth::check()` are available under the Facade `\Illuminate\Support\Facades\Auth`;
 
+The facade Oauth2 provides all helpers needed to get and post data from the Oauth Server.
+
 ## _View components_
 
 `@openidComponents`:
 
 For load the user's logged menu, the fast access with the users permissions and render the Login Button in case you have not authenticated page, just call the Blade directive under your header component.
 
-`@login(route.name)`:
+`@login('route.name')`:
 
-The login directive will call the route you 
+The login directive will call the route you pass or return the oauth path formated with the continue parameter to the required route.
 
 ## _Redirecting routes_
 
 The dynamic route from Oauth system can redirect the user back to the source using the `?continue` url parameter.
 
 The following example will be redirect back to the source after the user executes the actions needed in the Oauth Service page:
 
-```
+```php
 config('openid.server') . '{$ouath_service_page}?' . http_build_query(['continue' => {$route_to_redirect_back}])
 ```

Services/Api.php

@@ -23,7 +23,7 @@ class Api
     private static $initialized = FALSE;
 
     /**
-     * Class constructor
+     * Static class constructor
      */
     private static function initialize()
     {
@@ -35,6 +35,8 @@ private static function initialize()
     }
 
     /**
+     * @api (GET '/api/{version}/system')
+     *
      * @return array
      */
     public static function getSystems()
@@ -43,6 +45,8 @@ public static function getSystems()
     }
 
     /**
+     * @api (GET '/api/{version}/system/roles')
+     *
      * @return array
      */
     public static function getSystemRoles()
@@ -51,6 +55,8 @@ public static function getSystemRoles()
     }
 
     /**
+     * @api (GET '/api/{version}/user')
+     *
      * @return array
      */
     public static function getUser()
@@ -59,6 +65,20 @@ public static function getUser()
     }
 
     /**
+     * @api (POST '/api/{version}/user/cpf')
+     *
+     * @param string $cpf
+     *
+     * @return array
+     */
+    public static function getUserByCpf(string $cpf)
+    {
+        return self::getResponse('user/cpf', ['cpf' => $cpf]);
+    }
+
+    /**
+     * @api (GET '/api/{version}/user/systems')
+     *
      * @return array
      */
     public static function getUserSystems()
@@ -67,6 +87,8 @@ public static function getUserSystems()
     }
 
     /**
+     * @api (GET '/api/{version}/user/permissions')
+     *
      * @return array
      */
     public static function getUserPermissions()
@@ -75,14 +97,29 @@ public static function getUserPermissions()
     }
 
     /**
+     * @api (POST '/api/{version}/user/permission')
+     *
+     * @param string $cpf
+     * @param string $role
+     * @param string $expires_at
      *
+     * @return array
      */
-    public static function createUserPermission()
+    public static function setUserPermission(string $cpf, string $role, string $expires_at = '')
     {
-        //
+        $params = [
+            'user' => $cpf,
+            'role' => $role,
+        ];
+
+        if ($expires_at !== '') $params['expires_at'] = date('Y-m-d', strtotime($expires_at));
+
+        return self::postData('user/permission', $params);
     }
 
     /**
+     * @api (GET '/api/{version}/address/states')
+     *
      * @return array
      */
     public static function getStates()
@@ -91,6 +128,8 @@ public static function getStates()
     }
 
     /**
+     * @api (GET '/api/{version}/address/cities/{state}')
+     *
      * @param string $state
      *
      * @return array
@@ -101,23 +140,64 @@ public static function getCities(string $state)
     }
 
     /**
+     * @api (GET '/api/{version}/address/filled')
+     *
      * @return array
      */
     public static function isAddressFilled()
     {
         return self::getResponse('address/filled');
     }
 
+    /**
+     * @api (POST '/api/{version}/address')
+     * @example
+     *
+     * @param array $data Requires 'zip', 'street', 'number', 'complement', 'district' and 'city' keys
+     *
+     * @return array
+     */
+    public static function setAddress(array $data)
+    {
+        $params = array_only($data, ['zip', 'street', 'number', 'complement', 'district', 'city']);
+
+        return self::postData('address', $params);
+    }
+
+    /**
+     * @param string $uri
+     * @param array  $params
+     *
+     * @return array
+     */
+    private static function getResponse(string $uri, array $params = []): array
+    {
+        self::initialize();
+
+        if(empty($params)) {
+            $response = self::$client->get('api/' . self::$version . '/' . $uri);
+        } else {
+            $response = self::$client->post('api/' . self::$version . '/' . $uri, [
+                'form_params' => $params,
+            ]);
+        }
+
+        return json_decode($response->getBody(), TRUE);
+    }
+
     /**
      * @param string $uri
+     * @param array  $data
      *
      * @return array
      */
-    private static function getResponse(string $uri): array
+    private static function postData(string $uri, array $data): array
     {
         self::initialize();
 
-        $response = self::$client->get('api/' . self::$version . '/' . $uri);
+        $response = self::$client->post('api/' . self::$version . '/' . $uri, [
+            'form_params' => $data,
+        ]);
 
         return json_decode($response->getBody(), TRUE);
     }