figma-console-mcp 0.1.0

package/dist/browser/local.js

@@ -0,0 +1,223 @@
+/**
+ * Local Browser Manager
+ * Connects to Figma Desktop via Chrome Remote Debugging Protocol
+ */
+import puppeteer from 'puppeteer-core';
+import { createChildLogger } from '../core/logger.js';
+const logger = createChildLogger({ component: 'local-browser' });
+/**
+ * Local Browser Manager
+ * Connects to existing Figma Desktop instance via remote debugging port
+ */
+export class LocalBrowserManager {
+    constructor(config) {
+        this.browser = null;
+        this.page = null;
+        this.config = config;
+    }
+    /**
+     * Connect to Figma Desktop via remote debugging port
+     */
+    async launch() {
+        if (this.browser) {
+            logger.info('Browser already connected, reusing instance');
+            return;
+        }
+        const { debugHost, debugPort } = this.config;
+        const browserURL = `http://${debugHost}:${debugPort}`;
+        logger.info({ browserURL }, 'Connecting to Figma Desktop');
+        try {
+            // Connect to existing browser (Figma Desktop)
+            this.browser = await puppeteer.connect({
+                browserURL,
+                defaultViewport: null, // Use Figma's viewport
+            });
+            logger.info('Connected to Figma Desktop successfully');
+            // Handle disconnection
+            this.browser.on('disconnected', () => {
+                logger.warn('Disconnected from Figma Desktop');
+                this.browser = null;
+                this.page = null;
+            });
+        }
+        catch (error) {
+            logger.error({ error, browserURL }, 'Failed to connect to Figma Desktop');
+            throw new Error(`Failed to connect to Figma Desktop at ${browserURL}.\n\n` +
+                `Make sure:\n` +
+                `1. Figma Desktop is running\n` +
+                `2. Figma was launched with: --remote-debugging-port=${debugPort}\n` +
+                `3. "Use Developer VM" is enabled in: Plugins → Development → Use Developer VM\n\n` +
+                `macOS launch command:\n` +
+                `  open -a "Figma" --args --remote-debugging-port=${debugPort}\n\n` +
+                `Error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Find the best page for plugin debugging
+     * Actively searches for pages with workers across ALL tabs
+     */
+    async findBestPage() {
+        if (!this.browser) {
+            return null;
+        }
+        const pages = await this.browser.pages();
+        // Find Figma pages with workers
+        const figmaPages = pages.filter(p => {
+            const url = p.url();
+            return url.includes('figma.com') && !url.includes('devtools');
+        });
+        if (figmaPages.length === 0) {
+            return null;
+        }
+        // Check each page for workers
+        const pagesWithWorkers = figmaPages
+            .map(p => ({
+            page: p,
+            workerCount: p.workers().length,
+            url: p.url()
+        }))
+            .filter(p => p.workerCount > 0)
+            .sort((a, b) => b.workerCount - a.workerCount); // Most workers first
+        if (pagesWithWorkers.length > 0) {
+            logger.info({
+                url: pagesWithWorkers[0].url,
+                workerCount: pagesWithWorkers[0].workerCount,
+                totalPagesWithWorkers: pagesWithWorkers.length
+            }, 'Found page with active plugin workers');
+            return pagesWithWorkers[0].page;
+        }
+        // No workers found - prefer design/file pages
+        const designPage = figmaPages.find(p => p.url().includes('/design/') || p.url().includes('/file/'));
+        return designPage || figmaPages[0];
+    }
+    /**
+     * Get active Figma page or create new one
+     * Prefers pages with active plugin workers for plugin debugging
+     */
+    async getPage() {
+        if (!this.browser) {
+            await this.launch();
+        }
+        // ALWAYS re-check for best page (don't cache if we might have missed workers)
+        const bestPage = await this.findBestPage();
+        if (bestPage) {
+            const workerCount = bestPage.workers().length;
+            logger.info({
+                url: bestPage.url(),
+                workerCount,
+                cached: this.page === bestPage
+            }, 'Selected page for monitoring');
+            this.page = bestPage;
+            return this.page;
+        }
+        // Fallback: Get any existing page or create new one
+        const pages = await this.browser.pages();
+        if (pages.length > 0 && pages[0].url() !== 'about:blank') {
+            logger.warn({ url: pages[0].url() }, 'No Figma pages found, using first available page');
+            this.page = pages[0];
+            return this.page;
+        }
+        // Last resort: Create new page
+        logger.warn('No suitable pages found, creating new page in Figma Desktop');
+        this.page = await this.browser.newPage();
+        return this.page;
+    }
+    /**
+     * Navigate to Figma URL
+     */
+    async navigateToFigma(figmaUrl) {
+        const page = await this.getPage();
+        // Default to Figma homepage if no URL provided
+        const url = figmaUrl || 'https://www.figma.com';
+        logger.info({ url }, 'Navigating to Figma');
+        try {
+            await page.goto(url, {
+                waitUntil: 'networkidle2',
+                timeout: 30000,
+            });
+            logger.info({ url }, 'Navigation successful');
+            return page;
+        }
+        catch (error) {
+            logger.error({ error, url }, 'Navigation failed');
+            throw new Error(`Failed to navigate to ${url}: ${error}`);
+        }
+    }
+    /**
+     * Reload current page
+     */
+    async reload(hardReload = false) {
+        if (!this.page || this.page.isClosed()) {
+            throw new Error('No active page to reload');
+        }
+        logger.info({ hardReload }, 'Reloading page');
+        try {
+            await this.page.reload({
+                waitUntil: 'networkidle2',
+                timeout: 30000,
+            });
+            logger.info('Page reloaded successfully');
+        }
+        catch (error) {
+            logger.error({ error }, 'Page reload failed');
+            throw new Error(`Page reload failed: ${error}`);
+        }
+    }
+    /**
+     * Execute JavaScript in page context
+     */
+    async evaluate(fn) {
+        const page = await this.getPage();
+        return page.evaluate(fn);
+    }
+    // Screenshot functionality removed - use Figma REST API's getImages() instead
+    // See: figma_take_screenshot and figma_get_component_image tools
+    /**
+     * Check if browser is connected
+     */
+    isRunning() {
+        return this.browser !== null && this.browser.isConnected();
+    }
+    /**
+     * Disconnect from browser (doesn't close Figma Desktop)
+     */
+    async close() {
+        if (!this.browser) {
+            return;
+        }
+        logger.info('Disconnecting from Figma Desktop');
+        try {
+            // Just disconnect, don't close Figma Desktop
+            this.browser.disconnect();
+            this.browser = null;
+            this.page = null;
+            logger.info('Disconnected from Figma Desktop successfully');
+        }
+        catch (error) {
+            logger.error({ error }, 'Failed to disconnect from browser');
+            throw error;
+        }
+    }
+    /**
+     * Get current page URL
+     */
+    getCurrentUrl() {
+        if (!this.page || this.page.isClosed()) {
+            return null;
+        }
+        return this.page.url();
+    }
+    /**
+     * Wait for navigation
+     */
+    async waitForNavigation(timeout = 30000) {
+        if (!this.page || this.page.isClosed()) {
+            throw new Error('No active page');
+        }
+        await this.page.waitForNavigation({
+            waitUntil: 'networkidle2',
+            timeout,
+        });
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/browser/local.js.map

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

package/dist/cloudflare/browser/base.js

@@ -0,0 +1,5 @@
+/**
+ * Browser Manager Interface
+ * Abstract interface for browser automation across different runtimes
+ */
+export {};

package/dist/cloudflare/browser/cloudflare.js

@@ -0,0 +1,156 @@
+/**
+ * Cloudflare Browser Manager
+ * Manages Puppeteer browser instance lifecycle for Cloudflare Browser Rendering API
+ */
+import puppeteer from '@cloudflare/puppeteer';
+import { createChildLogger } from '../core/logger.js';
+const logger = createChildLogger({ component: 'cloudflare-browser' });
+/**
+ * Cloudflare Browser Manager
+ * Implements IBrowserManager for Cloudflare Browser Rendering API
+ */
+export class CloudflareBrowserManager {
+    constructor(env, config) {
+        this.browser = null;
+        this.page = null;
+        this.env = env;
+        this.config = config;
+    }
+    /**
+     * Launch browser instance via Cloudflare Browser Rendering API
+     */
+    async launch() {
+        if (this.browser) {
+            logger.info('Browser already running, reusing instance');
+            return;
+        }
+        logger.info('Launching browser with Cloudflare Browser Rendering API');
+        try {
+            this.browser = await puppeteer.launch(this.env.BROWSER, {
+                keep_alive: 600000, // Keep alive for 10 minutes
+            });
+            logger.info('Browser launched successfully');
+        }
+        catch (error) {
+            logger.error({ error }, 'Failed to launch browser');
+            throw new Error(`Browser launch failed: ${error}`);
+        }
+    }
+    /**
+     * Get or create a page instance
+     */
+    async getPage() {
+        if (!this.browser) {
+            await this.launch();
+        }
+        if (this.page && !this.page.isClosed()) {
+            return this.page;
+        }
+        logger.info('Creating new browser page');
+        this.page = await this.browser.newPage();
+        // Set viewport size
+        await this.page.setViewport({
+            width: 1920,
+            height: 1080,
+            deviceScaleFactor: 1,
+        });
+        logger.info('Browser page created');
+        return this.page;
+    }
+    /**
+     * Navigate to Figma URL
+     */
+    async navigateToFigma(figmaUrl) {
+        const page = await this.getPage();
+        // Default to Figma homepage if no URL provided
+        const url = figmaUrl || 'https://www.figma.com';
+        logger.info({ url }, 'Navigating to Figma');
+        try {
+            await page.goto(url, {
+                waitUntil: 'networkidle2',
+                timeout: 30000,
+            });
+            logger.info({ url }, 'Navigation successful');
+            return page;
+        }
+        catch (error) {
+            logger.error({ error, url }, 'Navigation failed');
+            throw new Error(`Failed to navigate to ${url}: ${error}`);
+        }
+    }
+    /**
+     * Reload current page
+     */
+    async reload(hardReload = false) {
+        if (!this.page || this.page.isClosed()) {
+            throw new Error('No active page to reload');
+        }
+        logger.info({ hardReload }, 'Reloading page');
+        try {
+            await this.page.reload({
+                waitUntil: 'networkidle2',
+                timeout: 30000,
+            });
+            logger.info('Page reloaded successfully');
+        }
+        catch (error) {
+            logger.error({ error }, 'Page reload failed');
+            throw new Error(`Page reload failed: ${error}`);
+        }
+    }
+    /**
+     * Execute JavaScript in page context
+     */
+    async evaluate(fn) {
+        const page = await this.getPage();
+        return page.evaluate(fn);
+    }
+    // Screenshot functionality removed - use Figma REST API's getImages() instead
+    // See: figma_take_screenshot and figma_get_component_image tools
+    /**
+     * Check if browser is running
+     */
+    isRunning() {
+        return this.browser !== null && this.browser.isConnected();
+    }
+    /**
+     * Close browser instance
+     */
+    async close() {
+        if (!this.browser) {
+            return;
+        }
+        logger.info('Closing browser');
+        try {
+            await this.browser.close();
+            this.browser = null;
+            this.page = null;
+            logger.info('Browser closed successfully');
+        }
+        catch (error) {
+            logger.error({ error }, 'Failed to close browser');
+            throw error;
+        }
+    }
+    /**
+     * Get current page URL
+     */
+    getCurrentUrl() {
+        if (!this.page || this.page.isClosed()) {
+            return null;
+        }
+        return this.page.url();
+    }
+    /**
+     * Wait for navigation
+     */
+    async waitForNavigation(timeout = 30000) {
+        if (!this.page || this.page.isClosed()) {
+            throw new Error('No active page');
+        }
+        await this.page.waitForNavigation({
+            waitUntil: 'networkidle2',
+            timeout,
+        });
+    }
+}

package/dist/cloudflare/browser-manager.js

@@ -0,0 +1,157 @@
+/**
+ * Browser Manager
+ * Manages Puppeteer browser instance lifecycle for Cloudflare Browser Rendering API
+ */
+import puppeteer from '@cloudflare/puppeteer';
+import { createChildLogger } from './core/logger.js';
+const logger = createChildLogger({ component: 'browser-manager' });
+/**
+ * Browser Manager
+ * Handles browser instance creation, page management, and navigation
+ */
+export class BrowserManager {
+    constructor(env, config) {
+        this.browser = null;
+        this.page = null;
+        this.env = env;
+        this.config = config;
+    }
+    /**
+     * Launch browser instance
+     */
+    async launch() {
+        if (this.browser) {
+            logger.info('Browser already running, reusing instance');
+            return this.browser;
+        }
+        logger.info('Launching browser with Cloudflare Browser Rendering API');
+        try {
+            this.browser = await puppeteer.launch(this.env.BROWSER, {
+                keep_alive: 600000, // Keep alive for 10 minutes
+            });
+            logger.info('Browser launched successfully');
+            return this.browser;
+        }
+        catch (error) {
+            logger.error({ error }, 'Failed to launch browser');
+            throw new Error(`Browser launch failed: ${error}`);
+        }
+    }
+    /**
+     * Get or create a page instance
+     */
+    async getPage() {
+        if (!this.browser) {
+            await this.launch();
+        }
+        if (this.page && !this.page.isClosed()) {
+            return this.page;
+        }
+        logger.info('Creating new browser page');
+        this.page = await this.browser.newPage();
+        // Set viewport size
+        await this.page.setViewport({
+            width: 1920,
+            height: 1080,
+            deviceScaleFactor: 1,
+        });
+        logger.info('Browser page created');
+        return this.page;
+    }
+    /**
+     * Navigate to Figma URL
+     */
+    async navigateToFigma(figmaUrl) {
+        const page = await this.getPage();
+        // Default to Figma homepage if no URL provided
+        const url = figmaUrl || 'https://www.figma.com';
+        logger.info({ url }, 'Navigating to Figma');
+        try {
+            await page.goto(url, {
+                waitUntil: 'networkidle2',
+                timeout: 30000,
+            });
+            logger.info({ url }, 'Navigation successful');
+            return page;
+        }
+        catch (error) {
+            logger.error({ error, url }, 'Navigation failed');
+            throw new Error(`Failed to navigate to ${url}: ${error}`);
+        }
+    }
+    /**
+     * Reload current page
+     */
+    async reload(hardReload = false) {
+        if (!this.page || this.page.isClosed()) {
+            throw new Error('No active page to reload');
+        }
+        logger.info({ hardReload }, 'Reloading page');
+        try {
+            await this.page.reload({
+                waitUntil: 'networkidle2',
+                timeout: 30000,
+            });
+            logger.info('Page reloaded successfully');
+        }
+        catch (error) {
+            logger.error({ error }, 'Page reload failed');
+            throw new Error(`Page reload failed: ${error}`);
+        }
+    }
+    /**
+     * Execute JavaScript in page context
+     */
+    async evaluate(fn) {
+        const page = await this.getPage();
+        return page.evaluate(fn);
+    }
+    // Screenshot functionality removed - use Figma REST API's getImages() instead
+    // See: figma_take_screenshot and figma_get_component_image tools
+    /**
+     * Check if browser is running
+     */
+    isRunning() {
+        return this.browser !== null && this.browser.isConnected();
+    }
+    /**
+     * Close browser instance
+     */
+    async close() {
+        if (!this.browser) {
+            return;
+        }
+        logger.info('Closing browser');
+        try {
+            await this.browser.close();
+            this.browser = null;
+            this.page = null;
+            logger.info('Browser closed successfully');
+        }
+        catch (error) {
+            logger.error({ error }, 'Failed to close browser');
+            throw error;
+        }
+    }
+    /**
+     * Get current page URL
+     */
+    getCurrentUrl() {
+        if (!this.page || this.page.isClosed()) {
+            return null;
+        }
+        return this.page.url();
+    }
+    /**
+     * Wait for navigation
+     */
+    async waitForNavigation(timeout = 30000) {
+        if (!this.page || this.page.isClosed()) {
+            throw new Error('No active page');
+        }
+        await this.page.waitForNavigation({
+            waitUntil: 'networkidle2',
+            timeout,
+        });
+    }
+}