ComunicWeb/assets/js/common/api.js

/**
 * API main functions
 * 
 * @author Pierre HUBERT
 */
const APIClient = {

    /**
     * Make an asynchronous request over the API
     * 
     * @returns {Promise}
     */
    exec: function(apiURI, args, withLogin) {

        if(!args)
            args = {};

        return new Promise((resolve, reject) => {

            this.makeAPIrequest(apiURI, args, withLogin, result => {
            
                if(result.error)
                    reject(result.error);
            
                else
                    resolve(result);

            });
        });
    },

    /**
     * @param {(number) => void} progressCallback Use this function to monitor upload
     * @returns {Promise}
     */
    execFormData: function(uri, data, withLogin, progressCallback) {
        if (!data)
            data = new FormData();
        
        return new Promise((res, rej) => {
            this.makeFormDatarequest(uri, data, withLogin, (result) => {
                if (result.error)
                    rej(result.error);
                
                else
                    res(result);
            }, progressCallback)
        });
    },

    /**
     * Make an API request
     * 
     * @param {String} apiURI The URI to call in the API
     * @param {Object} params The params to include in request
     * @param {Boolean} requireLoginTokens Specify if login tokens are required or not
     * @param {Function} nextAction What to do next
     */
    makeAPIrequest: function(apiURI, params, requireLoginTokens, nextAction){
        //Prepare the request URL
        var requestURL = ComunicWeb.__config.apiURL + apiURI;
        
        // Add client name
        params.client = ComunicWeb.__config.apiClientName;

        //Add login tokens to params if required
        if(requireLoginTokens){
            params.token = LoginTokens.getLoginToken();
        }

        //Enable incognito mode if required
        if(ComunicWeb.components.incognito.management.isEnabled())
            params.incognito = true;

        //Prepare data to send in request
        var count = 0;
        var datas = "";
        for(paramName in params){
            //We add a "&" if it isn't the first param
            if(count != 0)
                datas += "&";

            //We add field value
            datas += encodeURIComponent(paramName) + "=" + encodeURIComponent(params[paramName]);

            count++; //Increment counter
        }     

        //Create request
        var apiXHR = new XMLHttpRequest();
        apiXHR.open("POST", requestURL);

        //Prepare request response
        apiXHR.onreadystatechange = function(){
            ComunicWeb.common.api._on_state_change(requestURL, apiXHR, nextAction);
        }

        //Set request headers
        apiXHR.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");

        //Submit request
        apiXHR.send(datas);
    },

    /**
     * Make an API request with a prepared form data object
     * 
     * @param {String} apiURI The URI to call in the API
     * @param {FormData} data The form data object
     * @param {Boolean} requireLoginTokens Specify if login tokens are required or not
     * @param {Function} nextAction What to do next
     * @param {(number) => void} progressCallback Use this function to monitor upload
     */
    makeFormDatarequest: function(apiURI, data, requireLoginTokens, nextAction, progressCallback){
        //Prepare the request URL
        var requestURL = ComunicWeb.__config.apiURL + apiURI;
        
        // Add API client name
        data.append('client', ComunicWeb.__config.apiClientName);

        //Add login tokens to params if required
        if(requireLoginTokens){
            data.append("token", LoginTokens.getLoginToken())
        }
        
        //Enable incognito mode if required
        if(ComunicWeb.components.incognito.management.isEnabled())
            data.append("incognito", true);

        //Create request
        var apiXHR = new XMLHttpRequest();
        apiXHR.open("POST", requestURL);

        //Prepare request response
        apiXHR.onreadystatechange = function(){
            ComunicWeb.common.api._on_state_change(requestURL, apiXHR, nextAction);
        }

        // Monitor upload progress, if required
        if (progressCallback)
            apiXHR.upload.addEventListener("progress", e => {
                progressCallback(e.loaded/e.total);
            });

        //Submit request
        apiXHR.send(data);
    },

    /**
     * Handle xhr request chnages
     * 
     * @param {string} requestURL The URL of the request
     * @param {XMLHttpRequest} apiXHR The request element
     * @param {Function} nextAction What to do once the request is done
     */
    _on_state_change: function(requestURL, apiXHR, nextAction){

        //We continue only if request is terminated
        if(apiXHR.readyState == 4){

            //Check if response code is 0
            ComunicWeb.common.network.setStatus(apiXHR.status != 0);

            //Check if response is empty
            if(apiXHR.responseText.length == ""){
                //Auto-create a response for empty responses (to avoid Javascript errors and allow the script to continue to execute)
                result = {
                    error : {
                        code: 0,
                        message: "Empty response",
                    },
                };
            }
            else {

                //Catch JSON parsing errors
                try {

                    //Parse result
                    var result = JSON.parse(apiXHR.responseText);

                } catch (error) {
                    
                    //Report error
                    ComunicWeb.common.error.syntaxtError(error, apiXHR.responseText);

                    //Set arbitray result content
                    result = {
                        error : {
                            code: 1,
                            message: "Invalid response",
                        },
                    };

                }
            }
                

            //We check if we got any error
            if(result.error){
                //Log error
                ComunicWeb.debug.logMessage("Got an error in a XHR request! \n Request URL: "+requestURL+" \n Response : "+apiXHR.responseText);

                if (result.error.code == 412 && signed_in()) {
                    UserLogin.__userLogin = false;
                    ComunicWeb.user.loginTokens.deleteLoginTokens();
                    System.restart();
                }
            }

            //We can do the next step
            if(nextAction)
                nextAction(result);
        }
    },
}

ComunicWeb.common.api = APIClient;