UNPKG

lunr-elastic-search

Version:

Uses Lunr.js to index and search the knowledge base.

492 lines (491 loc) 15.1 kB
<!doctype html> <html lang="en"> <head> <title>Code coverage report for src/plugin/freshdesk.js</title> <meta charset="utf-8" /> <link rel="stylesheet" href="../../prettify.css" /> <link rel="stylesheet" href="../../base.css" /> <meta name="viewport" content="width=device-width, initial-scale=1"> <style type='text/css'> .coverage-summary .sorter { background-image: url(../../sort-arrow-sprite.png); } </style> </head> <body> <div class='wrapper'> <div class='pad1'> <h1> <a href="../../index.html">all files</a> / <a href="index.html">src/plugin/</a> freshdesk.js </h1> <div class='clearfix'> <div class='fl pad1y space-right2'> <span class="strong">100% </span> <span class="quiet">Statements</span> <span class='fraction'>52/52</span> </div> <div class='fl pad1y space-right2'> <span class="strong">93.33% </span> <span class="quiet">Branches</span> <span class='fraction'>14/15</span> </div> <div class='fl pad1y space-right2'> <span class="strong">100% </span> <span class="quiet">Functions</span> <span class='fraction'>28/28</span> </div> <div class='fl pad1y space-right2'> <span class="strong">100% </span> <span class="quiet">Lines</span> <span class='fraction'>30/30</span> </div> </div> </div> <div class='status-line high'></div> <pre><table class="coverage"> <tr><td class="line-count quiet">1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143</td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes">28×</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes">16×</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes">16×</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes">24×</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes">44×</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes">52×</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes">52×</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes">52×</span> <span class="cline-any cline-yes">72×</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes">52×</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes">36×</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes">36×</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes">36×</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes">36×</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes">252×</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes">36×</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import * as util from '../util' import _axios from 'axios' import flatten from 'array-flatten' &nbsp; const fields = ['title', 'description_text', 'body_text', 'tags', 'meta_title', 'meta_description', 'meta_keywords'] // the fields that will be indexed &nbsp; /** * The lunr.js builder plugin. * Meant to be used like `builder.use(plugin)` * * @memberof plugin.freshdesk * @return {void} */ function plugin () { this.ref('id') fields.forEach(f =&gt; this.field(f)) } &nbsp; /** * Fetches all the solution articles and forum posts from the designated source. * * @memberof plugin.freshdesk * @param {string} domain the domain of the API to make the request to * @param {string} user the username for the API * @param {string} pass the password for the API * @return {object[]} a list of processed solution articles, forum topics, and forum comments */ async function fetch ( domain, user, pass ) { const solutions = _axios.create({ baseURL: `https://${domain}.freshdesk.com/api/v2/solutions/`, auth: { username: user, password: pass } }) &nbsp; // gets a list of all the articles const categories = await get(solutions, 'categories') const folders = await getAllItemsIn(categories, solutions, id =&gt; `categories/${id}/folders`) const articles = await getAllItemsIn(folders, solutions, id =&gt; `folders/${id}/articles`) const processedArticles = await getAllItemsIn(articles, solutions, id =&gt; `articles/${id}`).then(arts =&gt; arts.map(a =&gt; process(a, 'solution'))) // process each article after fetching it &nbsp; const posts = _axios.create({ baseURL: `https://${domain}.freshdesk.com/api/v2/discussions/`, auth: { username: user, password: pass } }) &nbsp; // gets a list of all the articles const discussionCategories = await get(posts, 'categories') const forums = await getAllItemsIn(discussionCategories, posts, id =&gt; `categories/${id}/forums`).then(ary =&gt; ary.filter(t =&gt; hasComments(t))) const topics = await getAllItemsIn(forums, posts, id =&gt; `forums/${id}/topics`).then(ary =&gt; ary.filter(t =&gt; hasComments(t))) const comments = await getAllItemsIn(topics, posts, id =&gt; `topics/${id}/comments`).then(cmts =&gt; cmts.map(comment =&gt; process(comment, 'forum'))) &nbsp; return [...comments, ...processedArticles, ...topics.map(e =&gt; process(e, 'forum'))] } &nbsp; function hasComments (topic) { return topic.comments_count &gt; 0 } &nbsp; /** * Helper function to get all the items from a list of parent resources. * * @private * @param {object[]} ary list of parent resources * @param {axios.Instance} axios the preconfigured axios instance * @param {Function} buildURL function to build the endpoint URL relative to the baseURL in the axios instance * @return {object[]} a list of child resources */ async function getAllItemsIn (ary, axios, buildURL) { return flatten.depth(await Promise.all(ary.map(({id}) =&gt; get(axios, buildURL(id)))), 1) } &nbsp; /** * Helper function to make axios get request. * * @private * @param {axios.Instance} axios the preconfigured axios instance * @param {string} url the url to access relative to the baseURL in the axios instance * @return {object} data of axios response */ async function get (axios, url) { return axios.get(url).then(({data}) =&gt; { let ret const baseURL = axios.defaults.baseURL &nbsp; if (data.constructor.name === 'Array') { ret = data.map(doc =&gt; { return {...doc, documentSource: {url: baseURL + url}} }) } else <span class="missing-if-branch" title="else path not taken" >E</span>if (data.constructor.name === 'Object') { ret = {...data, documentSource: {url: baseURL + url}} } &nbsp; return ret }) } &nbsp; /** * Modify the documents so that they can be indexed correctly. * * @memberof plugin.freshdesk * @param {object} doc the document to be processed * @param {?string} source the source of the document * @return {object} the processed document */ function process (doc, source = '') { const obj = {...doc} // dup the document &nbsp; obj.tags = obj.tags ? obj.tags.join(' ') : '' // lunr can't index an array of strings so join the tags into 1 string &nbsp; if (obj.seo_data) Object.keys(obj.seo_data).forEach(k =&gt; { obj[k] = obj.seo_data[k] }) // map seo_data to root field so that it can indexed (lunr can't index nested fields) &nbsp; if (obj.documentSource) obj.documentSource = {...obj.documentSource, type: source} &nbsp; fields.forEach(f =&gt; { obj[f] = obj[f] || '' }) // if any fields are null then it will impact lunr search results &nbsp; return obj } &nbsp; /** * Checks to see if certain functions are defined. * * @return {Boolean} * @memberOf plugin.freshdesk */ function isSupported () { return util.definedFunction(Object.keys) &amp;&amp; util.definedFunction([].forEach) } &nbsp; /** * Contains functions for interacting with the freshdesk API and processing those responses. * * @namespace freshdesk * @memberOf plugin */ export {fields, plugin, process, fetch, isSupported} &nbsp;</pre></td></tr> </table></pre> <div class='push'></div><!-- for sticky footer --> </div><!-- /wrapper --> <div class='footer quiet pad2 space-top1 center small'> Code coverage generated by <a href="http://istanbul-js.org/" target="_blank">istanbul</a> at Fri Jan 05 2018 03:55:09 GMT+0000 (UTC) </div> </div> <script src="../../prettify.js"></script> <script> window.onload = function () { if (typeof prettyPrint === 'function') { prettyPrint(); } }; </script> <script src="../../sorter.js"></script> </body> </html>