@cosmocoder/mcp-web-docs 1.0.0

package/build/util/content-utils.js

@@ -0,0 +1,120 @@
+/**
+ * Utilities for cleaning and formatting content
+ */
+/**
+ * Cleans text content by normalizing whitespace and line endings
+ */
+export function cleanTextContent(text) {
+    return text
+        .replace(/\\n/g, '\n') // Convert escaped newlines
+        .replace(/\r\n/g, '\n') // Normalize line endings
+        .replace(/\t/g, '  ') // Convert tabs to spaces
+        .replace(/[^\S\n]+/g, ' ') // Replace multiple spaces with single space (except newlines)
+        .split('\n')
+        .map(line => line.trim()) // Trim each line
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n') // Max 2 consecutive newlines
+        .trim();
+}
+/**
+ * Cleans and formats code blocks
+ */
+export function cleanupCode(code) {
+    return code
+        .replace(/^\s+|\s+$/g, '') // Trim whitespace
+        .replace(/\t/g, '  ') // Convert tabs to spaces
+        .replace(/\n{3,}/g, '\n\n') // Reduce multiple blank lines
+        .replace(/\u00A0/g, ' ') // Replace non-breaking spaces
+        .replace(/\r\n/g, '\n') // Normalize line endings
+        .replace(/[ \t]+$/gm, '') // Remove trailing spaces
+        .replace(/^\n+|\n+$/g, ''); // Trim leading/trailing newlines
+}
+/**
+ * Formats a code block with language specification
+ */
+export function formatCodeBlock(code, language) {
+    const cleanCode = cleanupCode(code);
+    return `\`\`\`${language}\n${cleanCode}\n\`\`\``;
+}
+/**
+ * Checks if an element is visible in the DOM
+ */
+export function isElementVisible(element) {
+    const style = window.getComputedStyle(element);
+    return style.display !== 'none' &&
+        style.visibility !== 'hidden' &&
+        style.opacity !== '0';
+}
+/**
+ * Extracts links and inline code from an element, converting to markdown
+ */
+export function extractLinks(element) {
+    let content = element.innerHTML;
+    // Handle links
+    const links = element.querySelectorAll('a');
+    links.forEach(link => {
+        const text = link.textContent?.trim();
+        const href = link.getAttribute('href');
+        if (text && href) {
+            const linkHtml = link.outerHTML;
+            content = content.replace(linkHtml, `[${text}](${href})`);
+        }
+    });
+    // Handle inline code elements
+    const codeElements = element.querySelectorAll('code, [class*="code"], [class*="inline-code"], [class*="monospace"]');
+    codeElements.forEach(code => {
+        const text = code.textContent?.trim();
+        if (text) {
+            const codeHtml = code.outerHTML;
+            content = content.replace(codeHtml, `\`${text}\``);
+        }
+    });
+    // Convert HTML to plain text while preserving markdown
+    const div = document.createElement('div');
+    div.innerHTML = content;
+    return div.textContent?.trim() || '';
+}
+/**
+ * Waits for Storybook API to be ready
+ */
+export async function waitForStorybookAPI() {
+    const maxAttempts = 5;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        const hasAPI = !!window.__STORYBOOK_CLIENT_API__;
+        if (hasAPI) {
+            const api = window.__STORYBOOK_CLIENT_API__;
+            if (api.storyStore && typeof api.storyStore.ready === 'function') {
+                await api.storyStore.ready();
+            }
+            break;
+        }
+        await new Promise(resolve => setTimeout(resolve, 1000));
+    }
+}
+/**
+ * Waits for Storybook content to be loaded
+ */
+export async function waitForStorybookContent(document) {
+    const maxAttempts = 10;
+    const delay = 500;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        await new Promise(resolve => setTimeout(resolve, delay));
+        const mainArea = document.querySelector('.sbdocs-content, #docs-root');
+        if (!mainArea)
+            continue;
+        const hasContent = mainArea.querySelector('h1') && (mainArea.querySelector('p') ||
+            mainArea.querySelector('table') ||
+            mainArea.querySelector('ul, ol') ||
+            mainArea.querySelector('[class*="docblock"]'));
+        if (hasContent) {
+            await new Promise(resolve => setTimeout(resolve, 500));
+            return mainArea;
+        }
+        const loadingIndicator = document.querySelector('[class*="loading"], [class*="pending"]');
+        if (!loadingIndicator) {
+            console.warn('No loading indicator found but content is missing');
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=content-utils.js.map

package/build/util/content-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-utils.js","sourceRoot":"","sources":["../../src/util/content-utils.ts"],"names":[],"mappings":"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"}

package/build/util/content.d.ts

@@ -0,0 +1 @@
+export declare function cleanContent(text: string): string;

package/build/util/content.js

@@ -0,0 +1,16 @@
+export function cleanContent(text) {
+    return text
+        .replace(/\\n/g, '\n') // Convert escaped newlines
+        .replace(/\r\n/g, '\n') // Normalize line endings
+        .replace(/\t/g, '  ') // Convert tabs to spaces
+        .replace(/[^\S\n]+/g, ' ') // Replace multiple spaces with single space (except newlines)
+        .replace(/\u00A0/g, ' ') // Replace non-breaking spaces
+        .replace(/[ \t]+$/gm, '') // Remove trailing spaces
+        .split('\n')
+        .map(line => line.trim()) // Trim each line
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n') // Max 2 consecutive newlines
+        .replace(/^\n+|\n+$/g, '') // Trim leading/trailing newlines
+        .trim();
+}
+//# sourceMappingURL=content.js.map

package/build/util/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/util/content.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI;SACR,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAQ,2BAA2B;SACxD,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAO,yBAAyB;SACtD,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAS,yBAAyB;SACtD,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAI,8DAA8D;SAC3F,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAM,8BAA8B;SAC3D,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAK,yBAAyB;SACtD,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAK,iBAAiB;SAC9C,IAAI,CAAC,IAAI,CAAC;SACV,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAG,6BAA6B;SAC1D,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAI,iCAAiC;SAC9D,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/build/util/docs.d.ts

@@ -0,0 +1 @@
+export declare function generateDocId(url: string, title: string): string;

package/build/util/docs.js

@@ -0,0 +1,26 @@
+export function generateDocId(url, title) {
+    const urlObj = new URL(url);
+    const pathParts = urlObj.pathname.split('/').filter(Boolean);
+    // For GitHub Pages (e.g., jimdo.github.io/ui/latest)
+    if (urlObj.hostname.endsWith('github.io')) {
+        const org = urlObj.hostname.split('.')[0];
+        const repo = pathParts[0];
+        return `${org}-${repo}`;
+    }
+    // For organization packages (e.g., @org/package)
+    if (title.includes('/')) {
+        return title.toLowerCase().replace(/[@/]/g, '-').replace(/\s+/g, '-');
+    }
+    // For regular packages, use the first part of the hostname
+    const hostParts = urlObj.hostname.split('.');
+    if (hostParts.length > 1) {
+        const mainPart = hostParts[0] === 'www' ? hostParts[1] : hostParts[0];
+        // If there's a specific product/package in the path, include it
+        if (pathParts.length > 0 && pathParts[0] !== 'docs') {
+            return `${mainPart}-${pathParts[0]}`;
+        }
+        return mainPart;
+    }
+    return urlObj.hostname;
+}
+//# sourceMappingURL=docs.js.map

package/build/util/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/util/docs.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,KAAa;IACtD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE7D,qDAAqD;IACrD,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1B,OAAO,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED,iDAAiD;IACjD,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACxE,CAAC;IAED,2DAA2D;IAC3D,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACtE,gEAAgE;QAChE,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;YACpD,OAAO,GAAG,QAAQ,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,MAAM,CAAC,QAAQ,CAAC;AACzB,CAAC"}

package/build/util/docs.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/util/docs.test.js

@@ -0,0 +1,49 @@
+import { generateDocId } from './docs.js';
+describe('Docs Utilities', () => {
+    describe('generateDocId', () => {
+        it('should generate ID for GitHub Pages URLs', () => {
+            const result = generateDocId('https://jimdo.github.io/ui/latest', 'UI Components');
+            expect(result).toBe('jimdo-ui');
+        });
+        it('should generate ID for GitHub Pages with subdirectory', () => {
+            const result = generateDocId('https://myorg.github.io/my-package/docs/guide', 'Guide');
+            expect(result).toBe('myorg-my-package');
+        });
+        it('should generate ID for scoped package titles', () => {
+            const result = generateDocId('https://example.com/docs', '@org/package-name');
+            expect(result).toBe('-org-package-name');
+        });
+        it('should generate ID from hostname for regular URLs', () => {
+            const result = generateDocId('https://docs.example.com/guide', 'Example Guide');
+            // Includes first path part since it's not 'docs'
+            expect(result).toBe('docs-guide');
+        });
+        it('should include path part for non-docs paths', () => {
+            const result = generateDocId('https://example.com/react-components', 'Components');
+            expect(result).toBe('example-react-components');
+        });
+        it('should exclude docs from path', () => {
+            const result = generateDocId('https://example.com/docs/getting-started', 'Getting Started');
+            expect(result).toBe('example');
+        });
+        it('should handle www prefix', () => {
+            const result = generateDocId('https://www.example.com/api', 'API Reference');
+            expect(result).toBe('example-api');
+        });
+        it('should handle simple hostname', () => {
+            const result = generateDocId('https://localhost:3000/', 'Local Docs');
+            // Port is not included in the hostname parsing
+            expect(result).toBe('localhost');
+        });
+        it('should handle URLs with query parameters', () => {
+            const result = generateDocId('https://docs.site.com/api?version=2', 'API v2');
+            // Includes path part
+            expect(result).toBe('docs-api');
+        });
+        it('should handle URLs with fragments', () => {
+            const result = generateDocId('https://example.com/guide#section', 'Guide');
+            expect(result).toBe('example-guide');
+        });
+    });
+});
+//# sourceMappingURL=docs.test.js.map

package/build/util/docs.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.test.js","sourceRoot":"","sources":["../../src/util/docs.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,MAAM,GAAG,aAAa,CAAC,mCAAmC,EAAE,eAAe,CAAC,CAAC;YACnF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;YAC/D,MAAM,MAAM,GAAG,aAAa,CAAC,+CAA+C,EAAE,OAAO,CAAC,CAAC;YACvF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,MAAM,MAAM,GAAG,aAAa,CAAC,0BAA0B,EAAE,mBAAmB,CAAC,CAAC;YAC9E,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;YAC3D,MAAM,MAAM,GAAG,aAAa,CAAC,gCAAgC,EAAE,eAAe,CAAC,CAAC;YAChF,iDAAiD;YACjD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,MAAM,GAAG,aAAa,CAAC,sCAAsC,EAAE,YAAY,CAAC,CAAC;YACnF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,MAAM,GAAG,aAAa,CAAC,0CAA0C,EAAE,iBAAiB,CAAC,CAAC;YAC5F,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;YAClC,MAAM,MAAM,GAAG,aAAa,CAAC,6BAA6B,EAAE,eAAe,CAAC,CAAC;YAC7E,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,MAAM,GAAG,aAAa,CAAC,yBAAyB,EAAE,YAAY,CAAC,CAAC;YACtE,+CAA+C;YAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,MAAM,GAAG,aAAa,CAAC,qCAAqC,EAAE,QAAQ,CAAC,CAAC;YAC9E,qBAAqB;YACrB,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,MAAM,MAAM,GAAG,aAAa,CAAC,mCAAmC,EAAE,OAAO,CAAC,CAAC;YAC3E,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/util/favicon.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Fetch favicon for a URL with timeout and size limits
+ * @param url - The URL to fetch favicon for
+ * @returns Base64 encoded favicon data URL or undefined
+ */
+export declare function fetchFavicon(url: URL): Promise<string | undefined>;

package/build/util/favicon.js

@@ -0,0 +1,88 @@
+import { logger } from './logger.js';
+/** Default timeout for favicon fetch requests (10 seconds) */
+const FETCH_TIMEOUT_MS = 10000;
+/** Maximum favicon file size (1MB) to prevent memory issues */
+const MAX_FAVICON_SIZE = 1024 * 1024;
+/**
+ * Fetch with timeout support
+ * @param url - URL to fetch
+ * @param timeoutMs - Timeout in milliseconds
+ * @returns Response object
+ */
+async function fetchWithTimeout(url, timeoutMs = FETCH_TIMEOUT_MS) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(url, { signal: controller.signal });
+        return response;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+/**
+ * Fetch favicon for a URL with timeout and size limits
+ * @param url - The URL to fetch favicon for
+ * @returns Base64 encoded favicon data URL or undefined
+ */
+export async function fetchFavicon(url) {
+    try {
+        // Try standard favicon.ico location
+        const faviconUrl = new URL('/favicon.ico', url.origin);
+        const response = await fetchWithTimeout(faviconUrl.toString());
+        if (response.ok) {
+            // Check content length before downloading
+            const contentLength = response.headers.get('content-length');
+            if (contentLength && parseInt(contentLength, 10) > MAX_FAVICON_SIZE) {
+                logger.debug(`[Favicon] Favicon too large: ${contentLength} bytes`);
+                return undefined;
+            }
+            const buffer = await response.arrayBuffer();
+            if (buffer.byteLength > MAX_FAVICON_SIZE) {
+                logger.debug(`[Favicon] Favicon too large: ${buffer.byteLength} bytes`);
+                return undefined;
+            }
+            const base64 = Buffer.from(buffer).toString('base64');
+            const mimeType = response.headers.get('content-type') || 'image/x-icon';
+            return `data:${mimeType};base64,${base64}`;
+        }
+        // Try HTML head meta tags
+        const pageResponse = await fetchWithTimeout(url.toString());
+        const html = await pageResponse.text();
+        // Look for favicon in meta tags
+        const iconMatch = html.match(/<link[^>]*?rel=["'](?:shortcut )?icon["'][^>]*?href=["']([^"']+)["'][^>]*>/i) ||
+            html.match(/<link[^>]*?href=["']([^"']+)["'][^>]*?rel=["'](?:shortcut )?icon["'][^>]*>/i);
+        if (iconMatch) {
+            const iconUrl = new URL(iconMatch[1], url.origin);
+            const iconResponse = await fetchWithTimeout(iconUrl.toString());
+            if (iconResponse.ok) {
+                // Check content length before downloading
+                const contentLength = iconResponse.headers.get('content-length');
+                if (contentLength && parseInt(contentLength, 10) > MAX_FAVICON_SIZE) {
+                    logger.debug(`[Favicon] Icon too large: ${contentLength} bytes`);
+                    return undefined;
+                }
+                const buffer = await iconResponse.arrayBuffer();
+                if (buffer.byteLength > MAX_FAVICON_SIZE) {
+                    logger.debug(`[Favicon] Icon too large: ${buffer.byteLength} bytes`);
+                    return undefined;
+                }
+                const base64 = Buffer.from(buffer).toString('base64');
+                const mimeType = iconResponse.headers.get('content-type') || 'image/x-icon';
+                return `data:${mimeType};base64,${base64}`;
+            }
+        }
+        return undefined;
+    }
+    catch (error) {
+        // Handle abort errors (timeout) differently
+        if (error instanceof Error && error.name === 'AbortError') {
+            logger.debug(`[Favicon] Timeout fetching favicon for ${url.origin}`);
+        }
+        else {
+            logger.debug(`[Favicon] Error fetching favicon for ${url.origin}:`, error);
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=favicon.js.map

package/build/util/favicon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"favicon.js","sourceRoot":"","sources":["../../src/util/favicon.ts"],"names":[],"mappings":"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"}

package/build/util/favicon.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/util/favicon.test.js

@@ -0,0 +1,140 @@
+import { fetchFavicon } from './favicon.js';
+describe('Favicon Utilities', () => {
+    beforeEach(() => {
+        fetchMock.resetMocks();
+    });
+    describe('fetchFavicon', () => {
+        it('should fetch standard favicon.ico', async () => {
+            const faviconData = new Uint8Array([0x00, 0x00, 0x01, 0x00]); // ICO header
+            fetchMock.mockResponseOnce(async () => ({
+                body: Buffer.from(faviconData).toString(),
+                headers: { 'content-type': 'image/x-icon' },
+            }));
+            const result = await fetchFavicon(new URL('https://example.com'));
+            expect(result).toBeDefined();
+            expect(result).toContain('data:image/x-icon;base64,');
+            expect(fetchMock).toHaveBeenCalledWith('https://example.com/favicon.ico', expect.objectContaining({ signal: expect.any(AbortSignal) }));
+        });
+        it('should return undefined when favicon.ico returns non-OK status and no meta tag found', async () => {
+            // favicon.ico returns 404
+            fetchMock.mockResponseOnce('', { status: 404 });
+            // HTML fallback - no icon link
+            fetchMock.mockResponseOnce('<html><head></head><body></body></html>');
+            const result = await fetchFavicon(new URL('https://example.com'));
+            expect(result).toBeUndefined();
+        });
+        it('should reject oversized favicons based on content-length header', async () => {
+            fetchMock.mockResponseOnce('', {
+                status: 200,
+                headers: {
+                    'content-type': 'image/x-icon',
+                    'content-length': '2000000', // 2MB, exceeds 1MB limit
+                },
+            });
+            const result = await fetchFavicon(new URL('https://example.com'));
+            expect(result).toBeUndefined();
+        });
+        it('should reject oversized favicons based on actual buffer size', async () => {
+            const oversizedData = new Uint8Array(1024 * 1024 + 1); // 1MB + 1 byte
+            fetchMock.mockResponseOnce(async () => ({
+                body: Buffer.from(oversizedData).toString(),
+                headers: { 'content-type': 'image/x-icon' },
+            }));
+            const result = await fetchFavicon(new URL('https://example.com'));
+            expect(result).toBeUndefined();
+        });
+        it('should fallback to HTML meta tag parsing when favicon.ico fails', async () => {
+            const faviconData = new Uint8Array([0x89, 0x50, 0x4e, 0x47]); // PNG header
+            // favicon.ico returns 404
+            fetchMock.mockResponseOnce('', { status: 404 });
+            // HTML page with icon link
+            fetchMock.mockResponseOnce('<html><head><link rel="icon" href="/icon.png"></head><body></body></html>');
+            // Fetch the icon from meta tag
+            fetchMock.mockResponseOnce(async () => ({
+                body: Buffer.from(faviconData).toString(),
+                headers: { 'content-type': 'image/png' },
+            }));
+            const result = await fetchFavicon(new URL('https://example.com'));
+            expect(result).toBeDefined();
+            expect(result).toContain('data:image/png;base64,');
+        });
+        it('should handle shortcut icon rel value', async () => {
+            const faviconData = new Uint8Array([0x00, 0x00, 0x01, 0x00]);
+            fetchMock.mockResponseOnce('', { status: 404 });
+            fetchMock.mockResponseOnce('<html><head><link rel="shortcut icon" href="/favicon.ico"></head></html>');
+            fetchMock.mockResponseOnce(async () => ({
+                body: Buffer.from(faviconData).toString(),
+                headers: { 'content-type': 'image/x-icon' },
+            }));
+            const result = await fetchFavicon(new URL('https://example.com'));
+            expect(result).toBeDefined();
+        });
+        it('should handle href before rel attribute order', async () => {
+            const faviconData = new Uint8Array([0x00, 0x00, 0x01, 0x00]);
+            fetchMock.mockResponseOnce('', { status: 404 });
+            fetchMock.mockResponseOnce('<html><head><link href="/my-icon.ico" rel="icon"></head></html>');
+            fetchMock.mockResponseOnce(async () => ({
+                body: Buffer.from(faviconData).toString(),
+                headers: { 'content-type': 'image/x-icon' },
+            }));
+            const result = await fetchFavicon(new URL('https://example.com'));
+            expect(result).toBeDefined();
+        });
+        it('should return undefined on network error', async () => {
+            fetchMock.mockRejectOnce(new Error('Network error'));
+            const result = await fetchFavicon(new URL('https://example.com'));
+            expect(result).toBeUndefined();
+        });
+        it('should return undefined on timeout (AbortError)', async () => {
+            const abortError = new Error('Aborted');
+            abortError.name = 'AbortError';
+            fetchMock.mockRejectOnce(abortError);
+            const result = await fetchFavicon(new URL('https://example.com'));
+            expect(result).toBeUndefined();
+        });
+        it('should handle response with content-type header', async () => {
+            const faviconData = new Uint8Array([0x00, 0x00, 0x01, 0x00]);
+            fetchMock.mockResponseOnce(async () => ({
+                body: Buffer.from(faviconData).toString(),
+                headers: { 'content-type': 'image/vnd.microsoft.icon' },
+            }));
+            const result = await fetchFavicon(new URL('https://example.com'));
+            expect(result).toBeDefined();
+            // Should use the content-type from the response
+            expect(result).toContain('data:image/vnd.microsoft.icon;base64,');
+        });
+        it('should handle relative icon URLs correctly', async () => {
+            const faviconData = new Uint8Array([0x89, 0x50, 0x4e, 0x47]);
+            fetchMock.mockResponseOnce('', { status: 404 });
+            fetchMock.mockResponseOnce('<html><head><link rel="icon" href="/assets/favicon.png"></head></html>');
+            fetchMock.mockResponseOnce(async () => ({
+                body: Buffer.from(faviconData).toString(),
+                headers: { 'content-type': 'image/png' },
+            }));
+            const result = await fetchFavicon(new URL('https://example.com/page'));
+            expect(result).toBeDefined();
+            expect(fetchMock).toHaveBeenCalledWith('https://example.com/assets/favicon.png', expect.any(Object));
+        });
+        it('should return undefined when icon from meta tag fails to load', async () => {
+            fetchMock.mockResponseOnce('', { status: 404 });
+            fetchMock.mockResponseOnce('<html><head><link rel="icon" href="/icon.png"></head></html>');
+            fetchMock.mockResponseOnce('', { status: 404 });
+            const result = await fetchFavicon(new URL('https://example.com'));
+            expect(result).toBeUndefined();
+        });
+        it('should reject oversized icons from meta tag', async () => {
+            fetchMock.mockResponseOnce('', { status: 404 });
+            fetchMock.mockResponseOnce('<html><head><link rel="icon" href="/icon.png"></head></html>');
+            fetchMock.mockResponseOnce('', {
+                status: 200,
+                headers: {
+                    'content-type': 'image/png',
+                    'content-length': '2000000',
+                },
+            });
+            const result = await fetchFavicon(new URL('https://example.com'));
+            expect(result).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=favicon.test.js.map

package/build/util/favicon.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"favicon.test.js","sourceRoot":"","sources":["../../src/util/favicon.test.ts"],"names":[],"mappings":"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"}

package/build/util/logger.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Simple logger that outputs to stderr (required for MCP servers)
+ * but with proper log level prefixes for clarity.
+ *
+ * MCP servers must keep stdout clean for JSON-RPC communication,
+ * so all logs go to stderr regardless of level.
+ *
+ * Security: All log output is automatically redacted to remove sensitive
+ * information like cookies, tokens, passwords, and API keys.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export declare const logger: {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+};

package/build/util/logger.js

@@ -0,0 +1,72 @@
+/**
+ * Simple logger that outputs to stderr (required for MCP servers)
+ * but with proper log level prefixes for clarity.
+ *
+ * MCP servers must keep stdout clean for JSON-RPC communication,
+ * so all logs go to stderr regardless of level.
+ *
+ * Security: All log output is automatically redacted to remove sensitive
+ * information like cookies, tokens, passwords, and API keys.
+ */
+import { redactForLogging } from './security.js';
+const LOG_LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+// Default to 'info' level, can be changed via environment variable
+const currentLevel = process.env.LOG_LEVEL || 'info';
+function shouldLog(level) {
+    return LOG_LEVEL_PRIORITY[level] >= LOG_LEVEL_PRIORITY[currentLevel];
+}
+function formatArg(arg) {
+    if (arg instanceof Error) {
+        // Error objects don't serialize well with JSON.stringify
+        const errorStr = `${arg.name}: ${arg.message}${arg.stack ? `\n${arg.stack}` : ''}`;
+        return redactForLogging(errorStr);
+    }
+    if (typeof arg === 'object' && arg !== null) {
+        try {
+            const jsonStr = JSON.stringify(arg, null, 2);
+            return redactForLogging(jsonStr);
+        }
+        catch {
+            return redactForLogging(String(arg));
+        }
+    }
+    return redactForLogging(String(arg));
+}
+function formatMessage(level, message, ...args) {
+    const timestamp = new Date().toISOString();
+    const prefix = `[${timestamp}] [${level.toUpperCase()}]`;
+    // Redact the main message as well
+    const safeMessage = redactForLogging(message);
+    if (args.length > 0) {
+        return `${prefix} ${safeMessage} ${args.map(formatArg).join(' ')}`;
+    }
+    return `${prefix} ${safeMessage}`;
+}
+export const logger = {
+    debug(message, ...args) {
+        if (shouldLog('debug')) {
+            console.error(formatMessage('debug', message, ...args));
+        }
+    },
+    info(message, ...args) {
+        if (shouldLog('info')) {
+            console.error(formatMessage('info', message, ...args));
+        }
+    },
+    warn(message, ...args) {
+        if (shouldLog('warn')) {
+            console.error(formatMessage('warn', message, ...args));
+        }
+    },
+    error(message, ...args) {
+        if (shouldLog('error')) {
+            console.error(formatMessage('error', message, ...args));
+        }
+    },
+};
+//# sourceMappingURL=logger.js.map

package/build/util/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/util/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAIjD,MAAM,kBAAkB,GAA6B;IACnD,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,mEAAmE;AACnE,MAAM,YAAY,GAAc,OAAO,CAAC,GAAG,CAAC,SAAsB,IAAI,MAAM,CAAC;AAE7E,SAAS,SAAS,CAAC,KAAe;IAChC,OAAO,kBAAkB,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,YAAY,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,SAAS,CAAC,GAAY;IAC7B,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,yDAAyD;QACzD,MAAM,QAAQ,GAAG,GAAG,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACnF,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC7C,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IACD,OAAO,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,aAAa,CAAC,KAAe,EAAE,OAAe,EAAE,GAAG,IAAe;IACzE,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,SAAS,MAAM,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC;IAEzD,kCAAkC;IAClC,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAE9C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,GAAG,MAAM,IAAI,WAAW,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACrE,CAAC;IACD,OAAO,GAAG,MAAM,IAAI,WAAW,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;CACF,CAAC"}

package/build/util/logger.test.d.ts

@@ -0,0 +1 @@
+export {};