figma-console-mcp 0.1.0

package/dist/cloudflare/test-browser.js

@@ -0,0 +1,88 @@
+/**
+ * Test script to verify Browser Rendering API access
+ * Run with: npx wrangler dev and visit /test-browser
+ */
+import puppeteer from '@cloudflare/puppeteer';
+export async function testBrowserRendering(env) {
+    const results = {
+        timestamp: new Date().toISOString(),
+        tests: [],
+    };
+    // Test 1: Check BROWSER binding exists
+    results.tests.push({
+        name: 'BROWSER binding exists',
+        passed: !!env.BROWSER,
+        details: env.BROWSER ? 'BROWSER binding found' : 'BROWSER binding missing',
+    });
+    if (!env.BROWSER) {
+        return {
+            ...results,
+            overall: 'FAILED',
+            message: 'BROWSER binding not found. Check wrangler.jsonc configuration.',
+        };
+    }
+    // Test 2: Try to launch browser
+    try {
+        const browser = await puppeteer.launch(env.BROWSER, { keep_alive: 60000 });
+        results.tests.push({
+            name: 'Browser launch',
+            passed: true,
+            details: 'Successfully launched browser instance',
+        });
+        // Test 3: Try to create page
+        try {
+            const page = await browser.newPage();
+            results.tests.push({
+                name: 'Create browser page',
+                passed: true,
+                details: 'Successfully created new page',
+            });
+            // Test 4: Try to navigate
+            try {
+                await page.goto('https://example.com', { waitUntil: 'networkidle0' });
+                results.tests.push({
+                    name: 'Navigate to URL',
+                    passed: true,
+                    details: 'Successfully navigated to example.com',
+                });
+                // Test 5: Get page title
+                const title = await page.title();
+                results.tests.push({
+                    name: 'Read page content',
+                    passed: true,
+                    details: `Page title: "${title}"`,
+                });
+                await page.close();
+            }
+            catch (error) {
+                results.tests.push({
+                    name: 'Navigate to URL',
+                    passed: false,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        catch (error) {
+            results.tests.push({
+                name: 'Create browser page',
+                passed: false,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        await browser.close();
+    }
+    catch (error) {
+        results.tests.push({
+            name: 'Browser launch',
+            passed: false,
+            error: error instanceof Error ? error.message : String(error),
+            hint: 'Browser Rendering API may not be enabled on your account',
+        });
+    }
+    const allPassed = results.tests.every((test) => test.passed);
+    return {
+        ...results,
+        overall: allPassed ? 'PASSED' : 'FAILED',
+        summary: `${results.tests.filter((t) => t.passed).length}/${results.tests.length} tests passed`,
+    };
+}

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Configuration management for Figma Console MCP server
+ */
+import type { ServerConfig } from './types/index.js';
+/**
+ * Load configuration from file or use defaults
+ */
+export declare function loadConfig(): ServerConfig;
+/**
+ * Validate configuration
+ */
+export declare function validateConfig(config: ServerConfig): void;
+/**
+ * Get configuration with validation
+ */
+export declare function getConfig(): ServerConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA6CrD;;GAEG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAqBzC;AA0BD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAkCzD;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAIxC"}

package/dist/config.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * Configuration management for Figma Console MCP server
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+exports.validateConfig = validateConfig;
+exports.getConfig = getConfig;
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+/**
+ * Default configuration values
+ */
+const DEFAULT_CONFIG = {
+    browser: {
+        headless: false,
+        args: [
+            '--disable-blink-features=AutomationControlled',
+            '--disable-dev-shm-usage',
+            '--no-sandbox', // Note: Only use in trusted environments
+        ],
+    },
+    console: {
+        bufferSize: 1000,
+        filterLevels: ['log', 'info', 'warn', 'error', 'debug'],
+        truncation: {
+            maxStringLength: 500,
+            maxArrayLength: 10,
+            maxObjectDepth: 3,
+            removeDuplicates: true,
+        },
+    },
+    screenshots: {
+        defaultFormat: 'png',
+        quality: 90,
+        storePath: (0, path_1.join)(process.env.TMPDIR || '/tmp', 'figma-console-mcp', 'screenshots'),
+    },
+};
+/**
+ * Possible config file locations (checked in order)
+ */
+const CONFIG_PATHS = [
+    // Environment variable override
+    process.env.FIGMA_CONSOLE_CONFIG,
+    // Project-local config
+    (0, path_1.join)(process.cwd(), '.figma-console-mcp.json'),
+    (0, path_1.join)(process.cwd(), 'figma-console-mcp.json'),
+    // User home config
+    (0, path_1.join)((0, os_1.homedir)(), '.config', 'figma-console-mcp', 'config.json'),
+    (0, path_1.join)((0, os_1.homedir)(), '.figma-console-mcp.json'),
+].filter((path) => path !== undefined);
+/**
+ * Load configuration from file or use defaults
+ */
+function loadConfig() {
+    // Try to load from config file
+    for (const configPath of CONFIG_PATHS) {
+        if ((0, fs_1.existsSync)(configPath)) {
+            try {
+                const fileContent = (0, fs_1.readFileSync)(configPath, 'utf-8');
+                const userConfig = JSON.parse(fileContent);
+                // Deep merge with defaults
+                const config = mergeConfig(DEFAULT_CONFIG, userConfig);
+                return config;
+            }
+            catch (error) {
+                console.error(`Failed to load config from ${configPath}:`, error);
+                // Continue to next config path
+            }
+        }
+    }
+    // No config file found, use defaults
+    return DEFAULT_CONFIG;
+}
+/**
+ * Deep merge two configuration objects
+ */
+function mergeConfig(defaults, overrides) {
+    return {
+        browser: {
+            ...defaults.browser,
+            ...(overrides.browser || {}),
+        },
+        console: {
+            ...defaults.console,
+            ...(overrides.console || {}),
+            truncation: {
+                ...defaults.console.truncation,
+                ...(overrides.console?.truncation || {}),
+            },
+        },
+        screenshots: {
+            ...defaults.screenshots,
+            ...(overrides.screenshots || {}),
+        },
+    };
+}
+/**
+ * Validate configuration
+ */
+function validateConfig(config) {
+    // Validate browser config
+    if (!Array.isArray(config.browser.args)) {
+        throw new Error('browser.args must be an array');
+    }
+    // Validate console config
+    if (config.console.bufferSize <= 0) {
+        throw new Error('console.bufferSize must be positive');
+    }
+    if (!Array.isArray(config.console.filterLevels)) {
+        throw new Error('console.filterLevels must be an array');
+    }
+    // Validate truncation config
+    const { truncation } = config.console;
+    if (truncation.maxStringLength <= 0) {
+        throw new Error('console.truncation.maxStringLength must be positive');
+    }
+    if (truncation.maxArrayLength <= 0) {
+        throw new Error('console.truncation.maxArrayLength must be positive');
+    }
+    if (truncation.maxObjectDepth <= 0) {
+        throw new Error('console.truncation.maxObjectDepth must be positive');
+    }
+    // Validate screenshot config
+    if (!['png', 'jpeg'].includes(config.screenshots.defaultFormat)) {
+        throw new Error('screenshots.defaultFormat must be "png" or "jpeg"');
+    }
+    if (config.screenshots.quality < 0 || config.screenshots.quality > 100) {
+        throw new Error('screenshots.quality must be between 0 and 100');
+    }
+}
+/**
+ * Get configuration with validation
+ */
+function getConfig() {
+    const config = loadConfig();
+    validateConfig(config);
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/core/config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Configuration management for Figma Console MCP server
+ */
+import type { ServerConfig } from './types/index.js';
+/**
+ * Load configuration from file or use defaults
+ */
+export declare function loadConfig(): ServerConfig;
+/**
+ * Validate configuration
+ */
+export declare function validateConfig(config: ServerConfig): void;
+/**
+ * Get configuration with validation
+ */
+export declare function getConfig(): ServerConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAqErD;;GAEG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAqBzC;AA+BD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAkCzD;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAIxC"}

package/dist/core/config.js

@@ -0,0 +1,162 @@
+/**
+ * Configuration management for Figma Console MCP server
+ */
+import { readFileSync, existsSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+/**
+ * Auto-detect server mode based on environment
+ */
+function detectMode() {
+    // If running in Workers environment, return cloudflare
+    if (typeof globalThis !== 'undefined' && 'caches' in globalThis) {
+        return 'cloudflare';
+    }
+    // Explicit env var override
+    const modeEnv = process.env.FIGMA_MCP_MODE?.toLowerCase();
+    if (modeEnv === 'local' || modeEnv === 'cloudflare') {
+        return modeEnv;
+    }
+    // Default to local for Node.js environments
+    return 'local';
+}
+/**
+ * Default configuration values
+ */
+const DEFAULT_CONFIG = {
+    mode: detectMode(),
+    browser: {
+        headless: false,
+        args: [
+            '--disable-blink-features=AutomationControlled',
+            '--disable-dev-shm-usage',
+            '--no-sandbox', // Note: Only use in trusted environments
+        ],
+    },
+    console: {
+        bufferSize: 1000,
+        filterLevels: ['log', 'info', 'warn', 'error', 'debug'],
+        truncation: {
+            maxStringLength: 500,
+            maxArrayLength: 10,
+            maxObjectDepth: 3,
+            removeDuplicates: true,
+        },
+    },
+    screenshots: {
+        defaultFormat: 'png',
+        quality: 90,
+        storePath: join(process.env.TMPDIR || '/tmp', 'figma-console-mcp', 'screenshots'),
+    },
+    local: {
+        debugHost: process.env.FIGMA_DEBUG_HOST || 'localhost',
+        debugPort: parseInt(process.env.FIGMA_DEBUG_PORT || '9222', 10),
+    },
+};
+/**
+ * Possible config file locations (checked in order)
+ */
+const CONFIG_PATHS = [
+    // Environment variable override
+    process.env.FIGMA_CONSOLE_CONFIG,
+    // Project-local config
+    join(process.cwd(), '.figma-console-mcp.json'),
+    join(process.cwd(), 'figma-console-mcp.json'),
+    // User home config
+    join(homedir(), '.config', 'figma-console-mcp', 'config.json'),
+    join(homedir(), '.figma-console-mcp.json'),
+].filter((path) => path !== undefined);
+/**
+ * Load configuration from file or use defaults
+ */
+export function loadConfig() {
+    // Try to load from config file
+    for (const configPath of CONFIG_PATHS) {
+        if (existsSync(configPath)) {
+            try {
+                const fileContent = readFileSync(configPath, 'utf-8');
+                const userConfig = JSON.parse(fileContent);
+                // Deep merge with defaults
+                const config = mergeConfig(DEFAULT_CONFIG, userConfig);
+                return config;
+            }
+            catch (error) {
+                console.error(`Failed to load config from ${configPath}:`, error);
+                // Continue to next config path
+            }
+        }
+    }
+    // No config file found, use defaults
+    return DEFAULT_CONFIG;
+}
+/**
+ * Deep merge two configuration objects
+ */
+function mergeConfig(defaults, overrides) {
+    return {
+        mode: overrides.mode || defaults.mode,
+        browser: {
+            ...defaults.browser,
+            ...(overrides.browser || {}),
+        },
+        console: {
+            ...defaults.console,
+            ...(overrides.console || {}),
+            truncation: {
+                ...defaults.console.truncation,
+                ...(overrides.console?.truncation || {}),
+            },
+        },
+        screenshots: {
+            ...defaults.screenshots,
+            ...(overrides.screenshots || {}),
+        },
+        local: {
+            ...defaults.local,
+            ...(overrides.local || {}),
+        },
+    };
+}
+/**
+ * Validate configuration
+ */
+export function validateConfig(config) {
+    // Validate browser config
+    if (!Array.isArray(config.browser.args)) {
+        throw new Error('browser.args must be an array');
+    }
+    // Validate console config
+    if (config.console.bufferSize <= 0) {
+        throw new Error('console.bufferSize must be positive');
+    }
+    if (!Array.isArray(config.console.filterLevels)) {
+        throw new Error('console.filterLevels must be an array');
+    }
+    // Validate truncation config
+    const { truncation } = config.console;
+    if (truncation.maxStringLength <= 0) {
+        throw new Error('console.truncation.maxStringLength must be positive');
+    }
+    if (truncation.maxArrayLength <= 0) {
+        throw new Error('console.truncation.maxArrayLength must be positive');
+    }
+    if (truncation.maxObjectDepth <= 0) {
+        throw new Error('console.truncation.maxObjectDepth must be positive');
+    }
+    // Validate screenshot config
+    if (!['png', 'jpeg'].includes(config.screenshots.defaultFormat)) {
+        throw new Error('screenshots.defaultFormat must be "png" or "jpeg"');
+    }
+    if (config.screenshots.quality < 0 || config.screenshots.quality > 100) {
+        throw new Error('screenshots.quality must be between 0 and 100');
+    }
+}
+/**
+ * Get configuration with validation
+ */
+export function getConfig() {
+    const config = loadConfig();
+    validateConfig(config);
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/console-monitor.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Console Monitor
+ * Captures and manages console logs from Figma plugins via Chrome DevTools Protocol
+ * Monitors both main page console AND Web Worker consoles (where Figma plugins run)
+ */
+import type { ConsoleLogEntry, ConsoleConfig } from './types/index.js';
+/**
+ * Console Monitor
+ * Listens to page console events and maintains a circular buffer of logs
+ * Also monitors Web Workers to capture Figma plugin console logs
+ */
+export declare class ConsoleMonitor {
+    private logs;
+    private config;
+    private isMonitoring;
+    private page;
+    private workers;
+    constructor(config: ConsoleConfig);
+    /**
+     * Start monitoring console logs on a page
+     * Accepts any puppeteer Page type (puppeteer-core or @cloudflare/puppeteer)
+     */
+    startMonitoring(page: any): Promise<void>;
+    /**
+     * Attach console listeners to a Web Worker
+     * This captures Figma plugin console logs
+     */
+    private attachWorkerListeners;
+    /**
+     * Process console message from Puppeteer
+     * @param msg - Console message from page or worker
+     * @param context - Where the message came from ('page' or 'worker')
+     * @param workerUrl - URL of the worker (if context is 'worker')
+     */
+    private processConsoleMessage;
+    /**
+     * Determine if log is from plugin or Figma based on URL
+     */
+    private determineSource;
+    /**
+     * Add log to circular buffer
+     */
+    private addLog;
+    /**
+     * Truncate string to max length
+     */
+    private truncateString;
+    /**
+     * Truncate value (string, array, object) intelligently
+     * Based on AgentDesk pattern to prevent context overflow
+     */
+    private truncateValue;
+    /**
+     * Get logs with optional filtering
+     */
+    getLogs(options?: {
+        count?: number;
+        level?: ConsoleLogEntry['level'] | 'all';
+        since?: number;
+    }): ConsoleLogEntry[];
+    /**
+     * Clear log buffer
+     */
+    clear(): number;
+    /**
+     * Stop monitoring
+     */
+    stopMonitoring(): void;
+    /**
+     * Get monitoring status
+     */
+    getStatus(): {
+        isMonitoring: boolean;
+        logCount: number;
+        bufferSize: number;
+        workerCount: number;
+        oldestTimestamp: number;
+        newestTimestamp: number;
+    };
+}
+//# sourceMappingURL=console-monitor.d.ts.map

package/dist/core/console-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-monitor.d.ts","sourceRoot":"","sources":["../../src/core/console-monitor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAQvE;;;;GAIG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,OAAO,CAA6B;gBAEhC,MAAM,EAAE,aAAa;IAIjC;;;OAGG;IACG,eAAe,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IA4I/C;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAgC7B;;;;;OAKG;YACW,qBAAqB;IAqEnC;;OAEG;IACH,OAAO,CAAC,eAAe;IA4BvB;;OAEG;IACH,OAAO,CAAC,MAAM;IAWd;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAqDrB;;OAEG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;QACzC,KAAK,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,eAAe,EAAE;IAqBrB;;OAEG;IACH,KAAK,IAAI,MAAM;IAOf;;OAEG;IACH,cAAc,IAAI,IAAI;IAWtB;;OAEG;IACH,SAAS;;;;;;;;CAUT"}