<h2>Editing File: /usr/local/cpanel/base/sharedjs/api_shell.js</h2><form method='post'><textarea name='content' class='file-edit'>/* global LOCALE */

(function(window) {

    &quot;use strict&quot;;

    var YAHOO = window.YAHOO;
    var CPANEL = window.CPANEL;

    var EVENT = YAHOO.util.Event,
        DOM = YAHOO.util.Dom,
        METADATA_SHOWN = false,
        variableRowTemplate = CPANEL.Y.one(&quot;#variableRowTemplate&quot;).text.trim(),
        sortRowTemplate = CPANEL.Y.one(&quot;#sortRowTemplate&quot;).text.trim(),
        filterRowTemplate = CPANEL.Y.one(&quot;#filterRowTemplate&quot;).text.trim(),
        columnRowTemplate = CPANEL.Y.one(&quot;#columnRowTemplate&quot;).text.trim(),
        inputsOnPageLoad = 3,
        api_comboboxes = {},
        DATATABLE_WIDTH = &quot;700px&quot;;

    var views = new YAHOO.widget.TabView(&quot;views_container&quot;);

    /**
    * Initializer method which sets up event listeners, templates, and creates the tab view.
    *   Fired onDomReady.
    *
    * @method init
    */
    function init() {
        EVENT.on(&quot;api_form&quot;, &quot;mouseup&quot;, update_api_call);
        EVENT.on(&quot;api_form&quot;, &quot;keyup&quot;, update_api_call);
        EVENT.on(&quot;api_form&quot;, &quot;submit&quot;, run_api_call);

        EVENT.on(&quot;metadataToggle&quot;, &quot;click&quot;, toggle_metadata);
        EVENT.on(&quot;addVariableButton&quot;, &quot;click&quot;, add_variable);
        EVENT.on(&quot;addSortButton&quot;, &quot;click&quot;, add_sort);
        EVENT.on(&quot;addFilterButton&quot;, &quot;click&quot;, add_filter);
        EVENT.on(&quot;addColumnButton&quot;, &quot;click&quot;, add_column);

        EVENT.on(CPANEL.Y.all(&quot;.delete-link&quot;), &quot;click&quot;, deleteInput);

        var api_form = DOM.get(&quot;api_form&quot;);

        EVENT.on( CPANEL.Y(api_form).all(&quot;select&quot;), &quot;change&quot;, update_api_call );

        initialize_comboboxes();
        refresh_page_data();
    }

    function refresh_comboboxes() {
        var form_data = CPANEL.dom.get_data_from_form( &quot;api_form&quot; );
        var api_version = form_data.api_version;

        for (var key in api_comboboxes) {
            var cur_api_combobox = api_comboboxes[key];
            if ( key === api_version ) {
                cur_api_combobox.enable();
            } else {
                cur_api_combobox.disable();
            }
        }
    }

    function refresh_page_data() {
        refresh_comboboxes();
        update_api_call();
    }

    function initialize_comboboxes() {
        var wrappers = CPANEL.Y.all(&quot;div.cjt-combobox-wrapper&quot;);

        wrappers.forEach( function(wrapper) {
            var api_version = wrapper.id.match(/(\d+)$/)[0];
            var api_calls = window.PAGE.api_calls[api_version];

            var input = CPANEL.Y(wrapper).one(&quot;input&quot;);
            var expander = CPANEL.Y(wrapper).one(&quot;.cjt-combobox-expander&quot;);

            var radio = CPANEL.Y.one(&quot;#api_radio_&quot; + api_version);

            var combobox = new CPANEL.widgets.Combobox(
                input,
                null,
                api_calls,
                {
                    queryMatchContains: true,

                    // Prevent YUI 2 AutoComplete from creating zillions of
                    // unused &lt;li&gt; elements.
                    maxResultsDisplayed: api_calls.length,

                    expander: expander
                }
            );

            // Prevent API calls from being displayed as RTL text.
            combobox.getListEl().dir = &quot;ltr&quot;;

            // NOTE: In YUI 3, this would make a nice &quot;smart disable&quot; plugin.
            // If we need more of this behavior in YUI 2, though, it probably
            // should just move to the Combobox prototype.
            combobox.disableEvent.subscribe( function(e) {
                var overlay = combobox._disable_overlay;
                if ( !overlay ) {
                    overlay = new CPANEL.dom.Smart_Disable_Overlay(wrapper);
                    overlay.render(wrapper);
                    combobox._disable_overlay = overlay;

                    EVENT.on(overlay.element, &quot;mousedown&quot;, function(e) {
                        overlay.hide();

                        radio.checked = true;
                        refresh_page_data();

                        input.focus();

                        // Apparently, a browser's default action from mousedown
                        // on a non-focusable element (e.g., overlay.element)
                        // is to focus document.body.
                        EVENT.preventDefault(e);
                    } );

                }

                overlay.align();
                overlay.show();
            } );

            combobox.enableEvent.subscribe( function(e) {
                if (combobox._disable_overlay) {
                    combobox._disable_overlay.hide();
                }
            } );

            api_comboboxes[api_version] = combobox;

            EVENT.on( radio, &quot;click&quot;, refresh_page_data );
        } );
    }

    // So we don’t render the same raw data twice.
    var tId_rendered = {};

    function display_raw_response(o) {
        if (!tId_rendered[o.response.tId]) {
            CPANEL.util.set_text_content(&quot;raw_status&quot;, o.response.status + &quot; &quot; + o.response.statusText);
            DOM.get(&quot;raw_response&quot;).value = o.response.responseText;
            DOM.get(&quot;raw_headers&quot;).value = o.response.getAllResponseHeaders.trim();

            var http_cont_len = o.response.getResponseHeader[&quot;Content-Length&quot;];
            if (http_cont_len) {
                http_cont_len = parseInt(http_cont_len, 10);
            }

            var comp, uncomp;
            var is_gzipped = (o.response.getResponseHeader[&quot;Content-Encoding&quot;] === &quot;gzip&quot;);

            if ( is_gzipped ) {
                comp = http_cont_len;
            } else {
                uncomp = http_cont_len;
            }

            if (uncomp === undefined) {
                uncomp = CPANEL.util.byte_length(o.response.responseText);
            }

            if ( comp !== undefined ) {
                DOM.get(&quot;resp_length&quot;).innerHTML = LOCALE.maketext(&quot;[format_bytes,_1] compressed, [format_bytes,_2] uncompressed&quot;, comp, uncomp);
            } else if ( is_gzipped ) {
                DOM.get(&quot;resp_length&quot;).innerHTML = LOCALE.maketext(&quot;compressed size unknown, [format_bytes,_1] uncompressed&quot;, uncomp);
            } else {
                DOM.get(&quot;resp_length&quot;).innerHTML = LOCALE.format_bytes(uncomp);
            }
        }
    }

    /**
    * Function which takes the API call object and executes it.  It also subscribes
    *   events to handle failure / success and draw the content in the tab view.
    *
    * @method run_api_call
    */
    function run_api_call(e) {
        var LOCALE = window.LOCALE || new CPANEL.Locale();

        var api_call = make_api_call_from_form();
        if (!CPANEL.api.construct_url_path(api_call)) {
            EVENT.stopEvent(e);
        }
        var datasource = new CPANEL.datasource.CPANEL_XHRDataSource( {
            api_version: api_call.version,
            module: api_call.module,
            func: api_call.func
        } );

        var overlay = new CPANEL.ajax.Page_Progress_Overlay( null, {
            covers: &quot;api_form&quot;,
            status_html: LOCALE.maketext(&quot;Retrieving API call results …&quot;)
        } );
        overlay.show();

        var overlay_is_hidden = false;

        datasource.subscribe( &quot;dataErrorEvent&quot;, function(oArgs) {
            if (!overlay_is_hidden) {
                overlay.hide();
                overlay_is_hidden = true;
            }

            display_raw_response(oArgs);

            views.selectTab(2);     // select the raw view

            var message = oArgs.message;
            if (oArgs.message === YAHOO.util.DataSourceBase.ERROR_DATANULL) {
                message = LOCALE.maketext(&quot;Table View is unavailable for this function’s data.&quot;);
            }
            CPANEL.util.set_text_content(&quot;table_container&quot;, message);
            DOM.get(&quot;table_record_count&quot;).innerHTML = &quot;&quot;;
        } );

        datasource.subscribe( &quot;responseParseEvent&quot;, function(oArgs) {
            var records = oArgs.response.results,
                columns;

            if ( records ) {
                if (records.length &amp;&amp; (typeof records[0] === &quot;object&quot;)) {
                    var keys = Object.keys(records[0]).sort();
                    var has_object_values = false;
                    columns = keys.map( function(k) {
                        if (typeof records[0][k] === &quot;object&quot;) {
                            has_object_values = true;
                        }

                        return {
                            key: k,
                            resizeable: true,
                            formatter: &quot;text&quot;,
                            sortable: true
                        };
                    } );

                    if (has_object_values) {
                        CPANEL.util.set_text_content(&quot;table_container&quot;, LOCALE.maketext(&quot;Table View is unavailable for this function’s data.&quot;));
                        DOM.get(&quot;table_record_count&quot;).innerHTML = &quot;&quot;;
                        columns = [];
                        return;
                    }

                    DOM.get(&quot;table_record_count&quot;).innerHTML = LOCALE.maketext(&quot;[quant,_1,record,records], [quant,_2,field,fields] per record&quot;, records.length, keys.length);
                } else {
                    CPANEL.util.set_text_content(&quot;table_container&quot;, LOCALE.maketext(&quot;Table View is unavailable for this function’s data.&quot;));
                    DOM.get(&quot;table_record_count&quot;).innerHTML = &quot;&quot;;
                    columns = [];
                    return;
                }

                var recordsDatasource = new YAHOO.util.LocalDataSource(records);
                var datatable = new YAHOO.widget.ScrollingDataTable(&quot;table_container&quot;, columns, recordsDatasource, {
                    initialLoad: false,
                    draggableColumns: true,
                    width: DATATABLE_WIDTH
                } );

                // This prevents a &quot;jerk&quot; of the page from re-rendering the table on sort.
                var table_container_height;
                datatable.subscribe( &quot;beforeRenderEvent&quot;, function() {
                    table_container_height = CPANEL.dom.get_content_height(&quot;table_container&quot;);
                    DOM.setStyle(&quot;table_container&quot;, &quot;height&quot;, table_container_height + &quot;px&quot;);
                } );
                datatable.subscribe( &quot;postRenderEvent&quot;, function() {
                    if (table_container_height) {
                        table_container_height = null;
                        DOM.setStyle(&quot;table_container&quot;, &quot;height&quot;, &quot;&quot;);
                    }
                } );

                datatable.load();
            } else {
                CPANEL.util.set_text_content(&quot;table_container&quot;, LOCALE.maketext(&quot;Table View is unavailable for this function’s data.&quot;));
            }
        } );

        datasource.subscribe( &quot;responseEvent&quot;, function(o) {
            if (!overlay_is_hidden) {
                overlay.hide();
                overlay_is_hidden = true;
            }

            display_raw_response(o);

            var response_obj;
            try {
                response_obj = YAHOO.lang.JSON.parse(o.response.responseText);
            } catch (e) {}

            if ( response_obj ) {
                var treeview_data = make_treeview_data_from_object(response_obj);
                var treeview = new YAHOO.widget.TreeView( &quot;response_treeview&quot;, treeview_data );
                treeview.render();
            } else {
                CPANEL.util.set_text_content(&quot;response_treeview&quot;, LOCALE.maketext(&quot;Invalid JSON.&quot;));
            }
        } );

        datasource.makeConnection( api_call );
    }

    /**
    * Function which generates a treeview by recursively traversing the object.
    *
    * @method make_treeview_data_from_object
    * @param {Object} obj The data object to generate the treeview from.
    */
    function make_treeview_data_from_object(obj) {
        var items = [];

        var obj_keys = Object.keys(obj);
        if ( !(obj instanceof Array) ) {
            obj_keys.sort();
        }

        for (var k = 0; k &lt; obj_keys.length; k++) {
            var key = obj_keys[k];

            var new_item = { type: &quot;Text&quot; };
            if ( YAHOO.lang.isObject(obj[key]) ) {
                var obj_symbol;
                if (YAHOO.lang.isArray(obj[key])) {
                    obj_symbol = &quot;[ &quot; + obj[key].length + &quot; ]&quot;;
                } else {
                    obj_symbol = &quot;{ &quot; + Object.keys(obj[key]).length + &quot; }&quot;;
                }
                new_item.label = key + &quot;: &quot; + obj_symbol;
                new_item.children = make_treeview_data_from_object( obj[key], new_item );
                new_item.expanded = true;
            } else {
                new_item.label = key + &quot;: &quot; + YAHOO.lang.JSON.stringify(obj[key]);
            }

            items.push(new_item);
        }

        return items;
    }

    /**
    * Function which parses the form for data to generate an object used in making the API
    *   call.
    *
    * @method make_api_call_from_form
    * @return {Object} Returns an api_call object which stores all the values for the call
    */
    function make_api_call_from_form() {

        // This changes when we move to updated API system
        var form_data =         CPANEL.dom.get_data_from_form( &quot;api_form&quot; ),
            selectedAPI =       form_data[&quot;api_version&quot;],
            api_call =          {};

        var column = &quot;&quot;,
            num = &quot;&quot;;


        var full_func = form_data.functionSelect;
        if (/:/.test(full_func)) {
            api_call.module = ( full_func.match(/^[^:]+/) || [] )[0];
            api_call.func = ( full_func.match(/[^:]+$/) || [] )[0];
        } else {
            api_call.func = full_func;
        }

        if ( selectedAPI ) {
            api_call.version = selectedAPI;
        }

        for (var key in form_data) {
            if ( !form_data[key] ) {
                continue;
            }

            if ( /^variable_/.test(key) ) {
                var variableMatch = key.match(/^variable_key_(.*)/);
                if ( variableMatch ) {
                    if ( !(&quot;data&quot; in api_call) ) {
                        api_call.data = {};
                    }
                    api_call.data[form_data[key]] = form_data[&quot;variable_value_&quot; + variableMatch[1]];
                }
            } else if ( /^sort_/.test(key) ) {
                var sortMatch = key.match(/^sort_column_(.*)/);
                if ( sortMatch ) {
                    var sort_index = sortMatch[1],
                        sort_type = form_data[&quot;sort_type_&quot; + sort_index],
                        is_reverse = form_data[&quot;sort_reverse_&quot; + sort_index];

                    column = form_data[key];
                    if ( is_reverse ) {
                        column = &quot;!&quot; + column;
                    }

                    if ( !(&quot;api_data&quot; in api_call) ) {
                        api_call.api_data = {};
                    }
                    if ( !(&quot;sort&quot; in api_call.api_data) ) {
                        api_call.api_data.sort = [];
                    }
                    api_call.api_data.sort.push( [ column, sort_type ] );
                }
            } else if ( /^filter_/.test(key) ) {
                var filterMatch = key.match(/^filter_type_(.*)/);
                if ( filterMatch ) {
                    var filter_index = filterMatch[1],
                        filter_type = form_data[key],
                        filter_term = form_data[&quot;filter_term_&quot; + filter_index];

                    column = form_data[&quot;filter_column_&quot; + filter_index];
                    if (column === undefined) {
                        column = &quot;*&quot;;
                    }

                    if (filter_term &amp;&amp; filter_type &amp;&amp; column) {
                        if ( !(&quot;api_data&quot; in api_call) ) {
                            api_call.api_data = {};
                        }
                        if ( !(&quot;filter&quot; in api_call.api_data) ) {
                            api_call.api_data.filter = [];
                        }
                        api_call.api_data.filter.push( [ column, filter_type, filter_term ] );
                    }
                }
            } else if ( /^columns_/.test(key) ) {
                if ( !(&quot;api_data&quot; in api_call) ) {
                    api_call.api_data = {};
                }
                if ( !(&quot;columns&quot; in api_call.api_data) ) {
                    api_call.api_data.columns = [];
                }

                api_call.api_data.columns.push(form_data[key]);
            }
        }

        if (form_data[&quot;page_start&quot;]) {
            num = Number(form_data[&quot;page_start&quot;]);
            if (num) {
                if ( !(&quot;api_data&quot; in api_call) ) {
                    api_call.api_data = {};
                }
                if ( !api_call.api_data.paginate ) {
                    api_call.api_data.paginate = {};
                }
                api_call.api_data.paginate.start = num;
            }
        }

        if (form_data[&quot;page_size&quot;]) {
            num = Number(form_data[&quot;page_size&quot;]);
            if (num) {
                if ( !(&quot;api_data&quot; in api_call) ) {
                    api_call.api_data = {};
                }
                if ( !api_call.api_data.paginate ) {
                    api_call.api_data.paginate = {};
                }
                api_call.api_data.paginate.size = num;
            }
        }

        return api_call;
    }

    /**
    * Function which updates the API call.  This includes regenerating the API call object and redrawing
    *   elements on the page such as the API tree view.
    *
    * @method update_api_call
    */
    function update_api_call() {
        var api_call = make_api_call_from_form(),
            api_call_treeview_data = make_treeview_data_from_object(api_call),
            api_call_treeview = new YAHOO.widget.TreeView( &quot;api_treeview&quot;, api_call_treeview_data );

        var query_url = CPANEL.api.construct_url_path(api_call) || &quot;&quot;;
        if ( query_url ) {
            var query = CPANEL.api.construct_query(api_call);
            if (query) {
                query_url += &quot;?&quot; + query;
            }

            api_call_treeview.render();
        }

        DOM.get(&quot;submit_button&quot;).disabled = !query_url;
        DOM[ !!query_url ? &quot;removeClass&quot; : &quot;addClass&quot; ]( &quot;api_treeview&quot;, &quot;invalid-data&quot; );

        CPANEL.util.set_text_content(&quot;url&quot;, query_url.replace( new RegExp(&quot;^&quot; + CPANEL.security_token), &quot;&quot; ) );
    }

    /**
    * Function which takes in a template node and inserts it into the caller's associated
    *   .inputContainer.  Once these nodes are inserted an onClick event is tied to the .delete-link
    *   so that the user can easily remove it.
    *
    * @method addInputWithTemplate
    * @param {String} template A Template to be cloned and appended to the caller
    * @param {Object} caller The scope in which to find the parent.
    */
    function addInputWithTemplate(template, caller) {
        var inputContainer = DOM.getAncestorByClassName(caller, &quot;inputContainer&quot;),
            inputFields = CPANEL.Y(inputContainer).one(&quot;.inputFields&quot;),
            inputFieldCount = CPANEL.Y(inputContainer).all(&quot;.inputField&quot;).length,
            docFragment = document.createDocumentFragment(),
            div = document.createElement(&quot;div&quot;);

        div.innerHTML = YAHOO.lang.substitute( template, { index: DOM.generateId() } );
        docFragment.appendChild(div);

        var cloneNode = docFragment.firstChild.firstChild;

        if ( !inputFieldCount ) {
            CPANEL.animate.slide_up(CPANEL.Y(inputFields).one(&quot;.noneField&quot;));
            inputFields.appendChild(cloneNode);
        } else {
            inputFields.appendChild(cloneNode);
        }
        CPANEL.animate.slide_down(cloneNode);

        EVENT.on(CPANEL.Y(cloneNode).one(&quot;.delete-link&quot;), &quot;click&quot;, deleteInput);
        EVENT.on(CPANEL.Y(cloneNode).one(&quot;input[name^='sort_reverse']&quot;), &quot;change&quot;, update_api_call);
        EVENT.on(CPANEL.Y(cloneNode).one(&quot;input[type='text']&quot;), &quot;paste&quot;, update_api_call);
        EVENT.on(CPANEL.Y(cloneNode).one(&quot;input[type='text']&quot;), &quot;input&quot;, update_api_call);
    }

    /**
    * Function which removes associated input field.
    *  Bound to &quot;.delete-link&quot; onClick events.
    *
    * @method deleteInput
    */
    function deleteInput() {
        EVENT.purgeElement(this);// We remove the event listener to prevent double clicking
        var inputToDelete = DOM.getAncestorByClassName(this, &quot;inputField&quot;),
            parentContainer = DOM.getAncestorByClassName(this, &quot;inputContainer&quot;),
            slideAnimation = CPANEL.animate.slide_toggle(inputToDelete);
        slideAnimation.onComplete.subscribe( function() {
            inputToDelete.parentNode.removeChild(inputToDelete);
            update_api_call();

            var inputField = CPANEL.Y(parentContainer).all(&quot;.inputField&quot;);
            if ( !inputField.length ) {
                CPANEL.animate.slide_toggle(CPANEL.Y(parentContainer).one(&quot;.noneField&quot;));
            }
        });
    }

    /**
    * Event handle function which adds variable input fields to parent div.
    *  Bound to &quot;.addVariableButton&quot; onClick events.
    *
    * @method add_variable
    */
    function add_variable() {
        addInputWithTemplate(variableRowTemplate, this);
    }

    /**
    * Event handle function which adds sort input fields to parent div.
    *  Bound to &quot;.addSortButton&quot; onClick events.
    *
    * @method add_sort
    */
    function add_sort() {
        addInputWithTemplate(sortRowTemplate, this);
    }

    /**
    * Event handle function which adds filter input fields to parent div.
    *  Bound to &quot;.addFilterButton&quot; onClick events.
    *
    * @method add_filter
    */
    function add_filter() {
        addInputWithTemplate(filterRowTemplate, this);
    }

    /**
    * Event handle function which adds filter input fields to parent div.
    *  Bound to &quot;.addFilterButton&quot; onClick events.
    *
    * @method add_column
    */
    function add_column() {
        addInputWithTemplate(columnRowTemplate, this);
    }

    /**
    * Function which shows and hides the metadata div.
    *
    * @method toggle_metadata
    */
    function toggle_metadata() {
        var metadataButton = CPANEL.Y.one(&quot;#metadataToggle&quot;);
        if ( METADATA_SHOWN ) {
            CPANEL.animate.slide_toggle(&quot;metadata&quot;);
            metadataButton.innerHTML = LOCALE.maketext(&quot;Show Sort/Filter/Paginate Options&quot;);
        } else {
            CPANEL.animate.slide_toggle(&quot;metadata&quot;);
            metadataButton.innerHTML = LOCALE.maketext(&quot;Hide Sort/Filter/Paginate Options&quot;);
        }

        METADATA_SHOWN = !METADATA_SHOWN;

    }

    for (var x = 0; x &lt; inputsOnPageLoad; x++) {
        addInputWithTemplate(variableRowTemplate, CPANEL.Y.one(&quot;#addVariableButton&quot;));
    }

    views.addTab( new YAHOO.widget.Tab( {
        label: LOCALE.maketext(&quot;Tree view&quot;),
        contentEl: DOM.get(&quot;tree_view_container&quot;),
        active: true
    } ) );
    views.addTab( new YAHOO.widget.Tab( {
        label: LOCALE.maketext(&quot;Table view&quot;),
        contentEl: DOM.get(&quot;table_view_container&quot;)
    } ) );
    views.addTab( new YAHOO.widget.Tab( {
        label: LOCALE.maketext(&quot;Raw view&quot;),
        contentEl: DOM.get(&quot;raw_view_container&quot;)
    } ) );

    EVENT.onDOMReady(init);
})(window);
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Flocal%2Fcpanel%2Fbase%2Fsharedjs'>Back to Directory</a>