una/modules/boonex/oauth2/classes/BxOAuthAPI.php

<?php defined('BX_DOL') or die('hack attempt');
/**
 * Copyright (c) UNA, Inc - https://una.io
 * MIT License - https://opensource.org/licenses/MIT
 *
 * @defgroup    OAuth2 OAuth2 server
 * @ingroup     UnaModules
 *
 * @{
 */

use OAuth2\Response;

class BxOAuthAPI extends BxDol
{
    protected $_oModule;
    protected $_oDb;
    public $aAction2Scope = array (
        'me' => 'basic,market,service,api',
        'user' => 'basic,market,service,api',
        'friends' => 'basic,market,service,api',
        'service' => 'service',
        'market' => 'market',
        'api' => 'api',
    );
    public $aExceptionsAPI = array ('output', 'errorOutput', 'isPublicAPI');

    function __construct($oModule)
    {
        $this->_oModule = $oModule;
        $this->_oDb = $oModule->_oDb;
    }

    /**
     * @page private_api API Private
     * @section private_api_me /m/oauth2/api/me
     * 
     * Provides information about current profile.  
     *
     * **Scopes:** 
     * `basic`, `service`, `market`
     * 
     * **HTTP Method:** 
     * `GET`
     *
     * **Request header:**
     * @code
     * Authorization: Bearer 9802c4a34e1535d8c3b721604ee0e7fb04116c49
     * @endcode
     *
     * **Response (success):**
     * @code
     * {  
     *     "id":"123",
     *     "type":"bx_organizations",
     *     "email":"test@example.com",
     *     "role":"1",
     *     "name":"Test",
     *     "profile_display_name":"Test",
     *     "profile_link":"http:\/\/example.com\/path-to-una\/page\/view-organization-profile?id=12",
     *     "picture":"http:\/\/example.com\/path-to-una\/image_transcoder.php?o=bx_organizations_picture&h=36&dpx=1&t=1496247306"
     * }
     * @endcode
     *
     * **Response (error):**
     * @code
     * {  
     *    "error":"short error description here",
     *    "error_description":"long error description here"
     * }
     * @endcode
     * 
     */
    function me($aToken)
    {        
        if (!($oProfile = BxDolProfile::getInstance($aToken['user_id']))) {
            $this->errorOutput('404', 'not_found', 'Profile was not found');
            return;
        }

        // get current account's profile (it maybe different if user switched to another profile)
        $oAccount = $oProfile->getAccountObject();
        if (!($oProfile = BxDolProfile::getInstanceByAccount($oAccount->id()))) {
            $this->errorOutput('404', 'not_found', 'Profile was not found');
            return;
        }

        $aClient = $this->_oDb->getClientsBy(array('type' => 'client_id', 'client_id' => $aToken['client_id']));

        $aProfile = $this->_prepareProfileArray($oProfile, false);
        $aProfile['owner'] = (int)$aProfile['id'] == (int)$aClient['user_id'];

        $this->output($aProfile);
    }

    /**
     * @page private_api API Private
     * @section private_api_user /m/oauth2/api/user
     * 
     * Provides information about particular profile profile.
     *
     * **Parameters:**
     * - `id` - profile ID
     *
     * Everything else is equivalent to @ref private_api_me
     */
    function user($aToken)
    {
        $iProfileId = (int)bx_get('id');

        if ($iProfileId == $aToken['user_id']) {
            $this->me($aToken);
            return;
        }

        if (!($oProfile = $this->_getProfileWithAccessChecking($iProfileId)))
            return;

        if (!(BxDolProfile::getInstance($aToken['user_id'])))
            return;

        $this->output($this->_prepareProfileArray($oProfile, !isAdmin()));
    }

    /**
     * @page private_api API Private
     * @section private_api_friends /m/oauth2/api/friends
     * 
     * Get list of friends.
     *
     * **Scopes:** 
     * `basic`, `service`, `market`
     * 
     * **HTTP Method:** 
     * `GET`
     *
     * **Parameters:**
     * - `id` - profile ID
     * 
     * **Request header:**
     * @code
     * Authorization: Bearer 9802c4a34e1535d8c3b721604ee0e7fb04116c49
     * @endcode
     *
     * **Response (success):**
     * @code
     * {  
     *     "user_id":30,
     *     "friends":[  
     *         "24",
     *         "29",
     *         "51"
     *     ]
     * }
     * @endcode
     *
     * **Response (error):**
     * @code
     * {  
     *    "error":"short error description here",
     *    "error_description":"long error description here"
     * }
     * @endcode
     * 
     */
    function friends($aToken)
    {
        $iProfileId = (int)bx_get('id');

        if (!($oProfile = $this->_getProfileWithAccessChecking($iProfileId)))
            return;

        if (!($oConn = BxDolConnection::getObjectInstance('sys_profiles_friends'))) {
            $this->errorOutput(405, 'not_supported', 'Friends lists aren\'t supported');
            return false;
        }
        
        $this->output(array(
            'user_id' => $iProfileId,
            'friends' => $oConn->getConnectedContent($iProfileId, true),
        ));
    }

    /**
     * @page private_api API Private
     * @section private_api_market /m/oauth2/api/market
     * 
     * Market service call.
     * 
     * **Scopes:** 
     * `market`, `service`
     *
     * Everything is equivalent to @ref private_api_service, only module name parameter can be ommited
     */
    function market($aToken) 
    {
    	$_GET['key'] = $_POST['key'] = $aToken['client_id'];
        $_GET['module'] = $_POST['module'] = 'bx_market_api';
        $this->service($aToken);
    }

    /**
     * @page public_api API Public
     * @section public_api_com /m/oauth2/api/com
     * 
     * API service call (com is for command). 
     * The call should be look this:
     * `/m/oauth2/api/com/[metod-name-here]`
     * 
     * **Scopes:** 
     * `api`
     *
     * Everything is equivalent to @ref private_api_service, 
     * only module name parameter can be ommited and 
     * method is passed as method parameter instead of GET/POST variable
     */
    function com($sMethod, $aToken, $bPublic)
    {
    	$_GET['key'] = $_POST['key'] = (isset($aToken['client_id']) ? $aToken['client_id'] : '');
        if (!isset($_GET['module']) && !isset($_POST['module']))
            $_GET['module'] = $_POST['module'] = 'bx_api';
        $_GET['method'] = $_POST['method'] = $sMethod;
        $this->service($aToken, $bPublic, true);
    }

    function isPublicAPI($sModule, $sMethod, $sClass = false)
    {
        return $this->_isAPI($sModule, $sMethod, $sClass, 'is_public_service');
    }

    function isSafeAPI($sModule, $sMethod, $sClass = false)
    {
        return $this->_isAPI($sModule, $sMethod, $sClass, 'is_safe_service');
    }

    protected function _isAPI($sModule, $sMethod, $sClass = false, $sCheckMethod = 'is_safe_service') 
    {
        if (!$sClass)
            $sClass = 'Module';

        if (!BxDolRequest::serviceExists($sModule, $sMethod, $sClass))
            return false;

        if (!BxDolRequest::serviceExists($sModule, $sCheckMethod, 'system' == $sModule ? 'TemplServices' : $sClass))
            return false;

        return BxDolService::call($sModule, $sCheckMethod, array($sMethod), 'system' == $sModule ? 'TemplServices' : $sClass);
    }
    

    /**
     * @page private_api API Private
     * @section private_api_service /m/oauth2/api/service
     * 
     * Perform system call. 
     * For a list of avalibale service calls and their parameters refer to @ref service page.
     * 
     * URL should look like this in case of service API call:
     * @code
     * http://example.com/m/oauth2/api/service?module=bx_market&method=test&params[]=1&params[]=abc&class=custom_class_name_or_remove_it_if_main_module_class
     * http://example.com/m/oauth2/api/service?module=bx_market&method=test&params=serialized_string_of_params
     * http://example.com/m/oauth2/api/service?module=bx_market&method=test&params=json_string_of_params
     * @endcode
     *
     * **Scopes:** 
     * `service`
     * 
     * **HTTP Method:** 
     * `GET`, `POST`
     *
     * **Parameters:**
     * - `module` - module name to perform service call in
     * - `method` - service call method
     * - `params` - parameters array
     * - `class` - custom module name if different from main module class
     * 
     * **Request header:**
     * @code
     * Authorization: Bearer 9802c4a34e1535d8c3b721604ee0e7fb04116c49
     * @endcode
     *
     * **Response (success):**
     * Depends on particular service call
     *
     * **Response (error):**
     * Error responce is described in particular service method.
     * In case of general error (for example when service call isn't found, or error with token), the format is following:
     * @code
     * {  
     *    "error":"short error description here",
     *    "error_description":"long error description here"
     * }
     * @endcode
     * 
     */
    function service($aToken, $bPublic = false, $bOutputResultOnly = false) 
    {
        if (!$bPublic && !($oProfile = BxDolProfile::getInstance($aToken['user_id']))) {
            $this->errorOutput('404', 'not_found', 'Profile was not found');
            return;
        }
        
        if (!$bPublic) {
            bx_login($oProfile->getAccountId(), false);
            check_logged();
        }

        $sModule = bx_get('module');
        $sMethod = bx_get('method');

        if (!($aParams = bx_get('params')))
            $aParams = array();
        elseif (is_string($aParams) && preg_match('/^\[.*\]$/', $aParams))
            $aParams = @json_decode($aParams);
        if (!is_array($aParams))
            $aParams = array($aParams);

        if (!($sClass = bx_get('class')))
            $sClass = 'Module';

        if (!preg_match('/^[A-Za-z0-9_]+$/', $sModule) || !preg_match('/^[A-Za-z0-9_]+$/', $sMethod) || !preg_match('/^[A-Za-z0-9_]+$/', $sClass)) {
            $this->errorOutput(500, 'error', 'Malformed request');
            return false;
        }

        if (!BxDolRequest::serviceExists($sModule, $sMethod, $sClass)) {
            $this->errorOutput(404, 'not_found', 'Service was not found');
            return false;
        }

        $mixedRet = BxDolService::call($sModule, $sMethod, $aParams, $sClass);

        if (is_array($mixedRet) && isset($mixedRet['error']) && isset($mixedRet['code'])) {
            $this->errorOutput($mixedRet['code'], $mixedRet['error'], isset($mixedRet['desc']) ? $mixedRet['desc'] : $mixedRet['error']);
            return false;
        }

        $this->output($bOutputResultOnly ? $mixedRet : array(
            'module' => $sModule,
            'method' => $sMethod,
            'data' => $mixedRet,
        ));
    }

    function errorOutput($iHttpCode, $sError, $sErrorDesc)
    {
        $oReponse = new Response();
        $oReponse->setError($iHttpCode, $sError, $sErrorDesc);
        $oReponse->send();
    }

    function output($a)
    {
        $oReponse = new Response();
        $oReponse->setParameters($a);
        $oReponse->send();
    }

    protected function _getProfileWithAccessChecking ($iProfileId) 
    {
        if (!$oProfile = BxDolProfile::getInstance($iProfileId)) {
            $this->errorOutput('404', 'not_found', 'Profile was not found');
            return false;
        }
/*        
        // TODO: check visibility
        if (!bx_check_profile_visibility($iProfileId, $aToken['user_id'], true)) {
            $this->errorOutput(403, 'access_denied', 'You have no rights to view this user info');
            return false;
        }
*/
        return $oProfile;
    }

    protected function _prepareProfileArray ($oProfile, $bPublicFieldsOnly = true) 
    {
        $oAccount = $oProfile->getAccountObject();
        $aProfileInfo = $oProfile->getInfo();
        $aAccountInfo = $oAccount->getInfo();

        if ($bPublicFieldsOnly) {
            $aProfileInfo = array(
                'id' => $aProfileInfo['id'],
            );
        } 
        else {
            unset($aProfileInfo['account_id']);
            unset($aProfileInfo['content_id']);
            unset($aProfileInfo['status']);

            // --- account's profiles info
            $aProfileInfo['email'] = $oAccount->getEmail();

            // ---- returns all accounts profiles React Jot
            $aProfiles = $oAccount->getProfiles();
            foreach($aProfiles as &$aProfile) {
               $oSubProfile = BxDolProfile::getInstance($aProfile['id']);
               $aProfileInfo['profiles'][$aProfile['id']] = array(
                    'name' => $oSubProfile->getDisplayName(),
                    'profile_link' => $oSubProfile->getUrl(),
                    'picture' => $oSubProfile->getThumb(),
                    'id' => $aProfile['id']
               );
            }

            // TODO: fetch extended info from profile module
        }


        $aProfileInfo['role'] = $aAccountInfo['role'];
        $aProfileInfo['name'] = $oAccount->getDisplayName();
        $aProfileInfo['profile_display_name'] = $oProfile->getDisplayName();
        $aProfileInfo['profile_link'] = $oProfile->getUrl();
        $aProfileInfo['picture'] = $oProfile->getPicture();
        $aProfileInfo['avatar'] = $oProfile->getAvatar();

		// ---- additional profile's fields for React Jot
        $aProfileInfo['cover'] = $oProfile->getCover();
        $aProfileInfo['followers'] = (int)BxDolConnection::getObjectInstance('sys_profiles_subscriptions')->getConnectedInitiatorsCount($aProfileInfo['id']);
        $aProfileInfo['following'] = (int)BxDolConnection::getObjectInstance('sys_profiles_subscriptions')->getConnectedContentCount($aProfileInfo['id']);
        $aProfileInfo['friends'] = (int)BxDolConnection::getObjectInstance('sys_profiles_friends')->getConnectedContentCount($aProfileInfo['id'], true);

        return $aProfileInfo;
    }

}

/** @} */