lamplighter-mcp

<!doctype html> <html lang="en"> <head> <title>Code coverage report for confluenceReader.ts</title> <meta charset="utf-8" /> <link rel="stylesheet" href="prettify.css" /> <link rel="stylesheet" href="base.css" /> <link rel="shortcut icon" type="image/x-icon" href="favicon.png" /> <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> confluenceReader.ts</h1> <div class='clearfix'> <div class='fl pad1y space-right2'> 90.16% Statements 55/61 </div> <div class='fl pad1y space-right2'> 65.38% Branches 17/26 </div> <div class='fl pad1y space-right2'> 100% Functions 4/4 </div> <div class='fl pad1y space-right2'> 91.22% Lines 52/57 </div> </div> Press n or j to go to the next uncovered block, b, p or k for the previous block. <template id="filterTemplate"> <div class="quiet"> Filter: <input type="search" id="fileSearch"> </div> </template> </div> <div class='status-line high'></div> <pre><table class="coverage"> <tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a> <a name='L2'></a><a href='#L2'>2</a> <a name='L3'></a><a href='#L3'>3</a> <a name='L4'></a><a href='#L4'>4</a> <a name='L5'></a><a href='#L5'>5</a> <a name='L6'></a><a href='#L6'>6</a> <a name='L7'></a><a href='#L7'>7</a> <a name='L8'></a><a href='#L8'>8</a> <a name='L9'></a><a href='#L9'>9</a> <a name='L10'></a><a href='#L10'>10</a> <a name='L11'></a><a href='#L11'>11</a> <a name='L12'></a><a href='#L12'>12</a> <a name='L13'></a><a href='#L13'>13</a> <a name='L14'></a><a href='#L14'>14</a> <a name='L15'></a><a href='#L15'>15</a> <a name='L16'></a><a href='#L16'>16</a> <a name='L17'></a><a href='#L17'>17</a> <a name='L18'></a><a href='#L18'>18</a> <a name='L19'></a><a href='#L19'>19</a> <a name='L20'></a><a href='#L20'>20</a> <a name='L21'></a><a href='#L21'>21</a> <a name='L22'></a><a href='#L22'>22</a> <a name='L23'></a><a href='#L23'>23</a> <a name='L24'></a><a href='#L24'>24</a> <a name='L25'></a><a href='#L25'>25</a> <a name='L26'></a><a href='#L26'>26</a> <a name='L27'></a><a href='#L27'>27</a> <a name='L28'></a><a href='#L28'>28</a> <a name='L29'></a><a href='#L29'>29</a> <a name='L30'></a><a href='#L30'>30</a> <a name='L31'></a><a href='#L31'>31</a> <a name='L32'></a><a href='#L32'>32</a> <a name='L33'></a><a href='#L33'>33</a> <a name='L34'></a><a href='#L34'>34</a> <a name='L35'></a><a href='#L35'>35</a> <a name='L36'></a><a href='#L36'>36</a> <a name='L37'></a><a href='#L37'>37</a> <a name='L38'></a><a href='#L38'>38</a> <a name='L39'></a><a href='#L39'>39</a> <a name='L40'></a><a href='#L40'>40</a> <a name='L41'></a><a href='#L41'>41</a> <a name='L42'></a><a href='#L42'>42</a> <a name='L43'></a><a href='#L43'>43</a> <a name='L44'></a><a href='#L44'>44</a> <a name='L45'></a><a href='#L45'>45</a> <a name='L46'></a><a href='#L46'>46</a> <a name='L47'></a><a href='#L47'>47</a> <a name='L48'></a><a href='#L48'>48</a> <a name='L49'></a><a href='#L49'>49</a> <a name='L50'></a><a href='#L50'>50</a> <a name='L51'></a><a href='#L51'>51</a> <a name='L52'></a><a href='#L52'>52</a> <a name='L53'></a><a href='#L53'>53</a> <a name='L54'></a><a href='#L54'>54</a> <a name='L55'></a><a href='#L55'>55</a> <a name='L56'></a><a href='#L56'>56</a> <a name='L57'></a><a href='#L57'>57</a> <a name='L58'></a><a href='#L58'>58</a> <a name='L59'></a><a href='#L59'>59</a> <a name='L60'></a><a href='#L60'>60</a> <a name='L61'></a><a href='#L61'>61</a> <a name='L62'></a><a href='#L62'>62</a> <a name='L63'></a><a href='#L63'>63</a> <a name='L64'></a><a href='#L64'>64</a> <a name='L65'></a><a href='#L65'>65</a> <a name='L66'></a><a href='#L66'>66</a> <a name='L67'></a><a href='#L67'>67</a> <a name='L68'></a><a href='#L68'>68</a> <a name='L69'></a><a href='#L69'>69</a> <a name='L70'></a><a href='#L70'>70</a> <a name='L71'></a><a href='#L71'>71</a> <a name='L72'></a><a href='#L72'>72</a> <a name='L73'></a><a href='#L73'>73</a> <a name='L74'></a><a href='#L74'>74</a> <a name='L75'></a><a href='#L75'>75</a> <a name='L76'></a><a href='#L76'>76</a> <a name='L77'></a><a href='#L77'>77</a> <a name='L78'></a><a href='#L78'>78</a> <a name='L79'></a><a href='#L79'>79</a> <a name='L80'></a><a href='#L80'>80</a> <a name='L81'></a><a href='#L81'>81</a> <a name='L82'></a><a href='#L82'>82</a> <a name='L83'></a><a href='#L83'>83</a> <a name='L84'></a><a href='#L84'>84</a> <a name='L85'></a><a href='#L85'>85</a> <a name='L86'></a><a href='#L86'>86</a> <a name='L87'></a><a href='#L87'>87</a> <a name='L88'></a><a href='#L88'>88</a> <a name='L89'></a><a href='#L89'>89</a> <a name='L90'></a><a href='#L90'>90</a> <a name='L91'></a><a href='#L91'>91</a> <a name='L92'></a><a href='#L92'>92</a> <a name='L93'></a><a href='#L93'>93</a> <a name='L94'></a><a href='#L94'>94</a> <a name='L95'></a><a href='#L95'>95</a> <a name='L96'></a><a href='#L96'>96</a> <a name='L97'></a><a href='#L97'>97</a> <a name='L98'></a><a href='#L98'>98</a> <a name='L99'></a><a href='#L99'>99</a> <a name='L100'></a><a href='#L100'>100</a> <a name='L101'></a><a href='#L101'>101</a> <a name='L102'></a><a href='#L102'>102</a> <a name='L103'></a><a href='#L103'>103</a> <a name='L104'></a><a href='#L104'>104</a> <a name='L105'></a><a href='#L105'>105</a> <a name='L106'></a><a href='#L106'>106</a> <a name='L107'></a><a href='#L107'>107</a> <a name='L108'></a><a href='#L108'>108</a> <a name='L109'></a><a href='#L109'>109</a> <a name='L110'></a><a href='#L110'>110</a> <a name='L111'></a><a href='#L111'>111</a> <a name='L112'></a><a href='#L112'>112</a> <a name='L113'></a><a href='#L113'>113</a> <a name='L114'></a><a href='#L114'>114</a> <a name='L115'></a><a href='#L115'>115</a> <a name='L116'></a><a href='#L116'>116</a> <a name='L117'></a><a href='#L117'>117</a> <a name='L118'></a><a href='#L118'>118</a> <a name='L119'></a><a href='#L119'>119</a> <a name='L120'></a><a href='#L120'>120</a> <a name='L121'></a><a href='#L121'>121</a> <a name='L122'></a><a href='#L122'>122</a> <a name='L123'></a><a href='#L123'>123</a> <a name='L124'></a><a href='#L124'>124</a> <a name='L125'></a><a href='#L125'>125</a> <a name='L126'></a><a href='#L126'>126</a> <a name='L127'></a><a href='#L127'>127</a> <a name='L128'></a><a href='#L128'>128</a> <a name='L129'></a><a href='#L129'>129</a> <a name='L130'></a><a href='#L130'>130</a> <a name='L131'></a><a href='#L131'>131</a> <a name='L132'></a><a href='#L132'>132</a> <a name='L133'></a><a href='#L133'>133</a> <a name='L134'></a><a href='#L134'>134</a> <a name='L135'></a><a href='#L135'>135</a> <a name='L136'></a><a href='#L136'>136</a> <a name='L137'></a><a href='#L137'>137</a> <a name='L138'></a><a href='#L138'>138</a> <a name='L139'></a><a href='#L139'>139</a> <a name='L140'></a><a href='#L140'>140</a> <a name='L141'></a><a href='#L141'>141</a> <a name='L142'></a><a href='#L142'>142</a> <a name='L143'></a><a href='#L143'>143</a> <a name='L144'></a><a href='#L144'>144</a> <a name='L145'></a><a href='#L145'>145</a> <a name='L146'></a><a href='#L146'>146</a> <a name='L147'></a><a href='#L147'>147</a> <a name='L148'></a><a href='#L148'>148</a> <a name='L149'></a><a href='#L149'>149</a> <a name='L150'></a><a href='#L150'>150</a> <a name='L151'></a><a href='#L151'>151</a> <a name='L152'></a><a href='#L152'>152</a> <a name='L153'></a><a href='#L153'>153</a> <a name='L154'></a><a href='#L154'>154</a> <a name='L155'></a><a href='#L155'>155</a> <a name='L156'></a><a href='#L156'>156</a> <a name='L157'></a><a href='#L157'>157</a> <a name='L158'></a><a href='#L158'>158</a> <a name='L159'></a><a href='#L159'>159</a> <a name='L160'></a><a href='#L160'>160</a> <a name='L161'></a><a href='#L161'>161</a> <a name='L162'></a><a href='#L162'>162</a> <a name='L163'></a><a href='#L163'>163</a> <a name='L164'></a><a href='#L164'>164</a> <a name='L165'></a><a href='#L165'>165</a> <a name='L166'></a><a href='#L166'>166</a> <a name='L167'></a><a href='#L167'>167</a></td><td class="line-coverage quiet">1x 1x       1x   1x           16x 16x 16x   16x 1x     15x 1x     14x 1x       13x   13x               10x 1x     9x 9x   9x       8x 8x     2x 2x     2x 2x     1x 1x           1x       8x       8x             4x 4x 4x     4x     4x     4x               1x     1x 1x     1x   1x   3x   3x                     3x                 5x     5x       5x             5x       5x     5x           5x    </td><td class="text"><pre class="prettyprint lang-js">import axios from 'axios'; import dotenv from 'dotenv'; import * as url from 'url';   // Load environment variables dotenv.config();   export class ConfluenceReader { private baseUrl: string; private apiToken: string; private username: string;   constructor() { this.baseUrl = process.env.CONFLUENCE_URL || ''; this.apiToken = process.env.CONFLUENCE_API_TOKEN || ''; this.username = process.env.CONFLUENCE_USERNAME || ''; if (!this.baseUrl) { throw new Error('Confluence URL is required. Set CONFLUENCE_URL in your environment variables.'); } if (!this.apiToken) { throw new Error('Confluence API token is required. Set CONFLUENCE_API_TOKEN in your environment variables.'); } if (!this.username) { throw new Error('Confluence username is required. Set CONFLUENCE_USERNAME in your environment variables.'); } // Remove trailing slash if present this.baseUrl = this.baseUrl.replace(/\/$/, ''); console.log(`[ConfluenceReader] Initialized with base URL: ${this.baseUrl}`); }   /** * Extract page ID from a Confluence URL or return the ID if directly provided */ private extractPageId(pageUrlOrId: string): string { // If it's just a number, assume it's already a page ID if (/^\d+$/.test(pageUrlOrId)) { return pageUrlOrId; } let pageId: string | null = null; try { // Parse the URL const parsedUrl = new URL(pageUrlOrId); // Extract the page ID from various Confluence URL formats // Format: .../pages/123456/Page+Title const pagesMatch = parsedUrl.pathname.match(/\/pages\/(\d+)/); if (pagesMatch) pageId = pagesMatch[1]; else { // Format: .../spaces/SPACE/pages/123456 const spacePagesMatch = parsedUrl.pathname.match(/\/spaces\/[^/]+\/pages\/(\d+)/); Iif (spacePagesMatch) pageId = spacePagesMatch[1]; else { // Format: .../view/123456 const viewMatch = parsedUrl.pathname.match(/\/view\/(\d+)/); if (viewMatch) pageId = viewMatch[1]; else { // Format: ...?pageId=123456 const pageIdParam = parsedUrl.searchParams.get('pageId'); if (pageIdParam) pageId = pageIdParam; } } } } catch (error) { // This catch block specifically handles URL parsing errors throw new Error(`Invalid Confluence URL format: ${pageUrlOrId}`); } // Check if an ID was found *after* trying to parse/extract Iif (!pageId) { throw new Error(`Could not extract page ID from URL: ${pageUrlOrId}`); }   return pageId; }   /** * Fetch content from a Confluence page by URL or ID */ async fetchPageContent(pageUrlOrId: string): Promise<string> { try { const pageId = this.extractPageId(pageUrlOrId); console.log(`[ConfluenceReader] Fetching page with ID: ${pageId}`); // Construct API URL for the content endpoint const apiUrl = `${this.baseUrl}/rest/api/content/${pageId}?expand=body.storage`; // Create Basic Auth token from username and API token const authToken = Buffer.from(`${this.username}:${this.apiToken}`).toString('base64'); // Make the API request const response = await axios.get(apiUrl, { headers: { 'Authorization': `Basic ${authToken}`, 'Content-Type': 'application/json' } }); // Extract the content from the response const htmlContent = response.data.body.storage.value; // Extract the title for reference const title = response.data.title; console.log(`[ConfluenceReader] Successfully fetched page: "${title}"`); // Process HTML content to extract the text const textContent = this.extractTextFromHtml(htmlContent); return textContent; } catch (error) { console.error('[ConfluenceReader] Error fetching page content:', error); Iif (axios.isAxiosError(error)) { if (error.response) { // The request was made and the server responded with a status code outside of 2xx throw new Error(`Confluence API error: ${error.response.status} - ${error.response.data?.message || 'Unknown error'}`); } else Iif (error.request) { // The request was made but no response was received throw new Error('No response received from Confluence. Please check your network connection and Confluence URL.'); } } // Generic error handling throw new Error(`Failed to fetch Confluence page: ${error instanceof Error ? error.message : String(error)}`); } }   /** * Extract readable text content from HTML * Very simple implementation - can be enhanced with a proper HTML parser if needed */ private extractTextFromHtml(html: string): string { let text = html; // 1. Remove script and style blocks first text = text.replace(/<script[^>]*>.*?<\/script>/gis, '') .replace(/<style[^>]*>.*?<\/style>/gis, '');   // 2. Replace common HTML entities text = text.replace(/&nbsp;/g, ' ') .replace(/&amp;/g, '&') .replace(/&lt;/g, '<') .replace(/&gt;/g, '>'); // 3. Replace line break elements with newlines // Add double newline after block elements for better spacing text = text.replace(/<br\s*\/?>/gi, '\n') .replace(/<\/(p|div|h[1-6]|li|blockquote)>/gi, '\n\n'); // 4. Strip remaining HTML tags text = text.replace(/<[^>]*>/g, ''); // 5. Clean up excessive whitespace text = text.replace(/[ \t]+/g, ' ') // Consolidate spaces/tabs .replace(/\n[ \t]+/g, '\n') // Remove leading space after newline .replace(/[ \t]+\n/g, '\n') // Remove trailing space before newline .replace(/\n{3,}/g, '\n\n') // Reduce multiple newlines to max 2 .trim(); // Final trim return text; } } </pre></td></tr></table></pre> <div class='push'></div> </div> <div class='footer quiet pad2 space-top1 center small'> Code coverage generated by <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a> at 2025-04-13T05:58:29.945Z </div> <script src="prettify.js"></script> <script> window.onload = function () { prettyPrint(); }; </script> <script src="sorter.js"></script> <script src="block-navigation.js"></script> </body> </html>